FireDAC.Comp.DataSet.TFDDataSet.LoadFromFile

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure LoadFromFile(const AFileName: String = ''; AFormat: TFDStorageFormat = sfAuto);

C++

void __fastcall LoadFromFile(const System::UnicodeString AFileName = System::UnicodeString(), Firedac::Stan::Intf::TFDStorageFormat AFormat = (Firedac::Stan::Intf::TFDStorageFormat)(0x0));

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure
function
public
FireDAC.Comp.DataSet.pas
FireDAC.Comp.DataSet.hpp
FireDAC.Comp.DataSet TFDDataSet


Beschreibung

Lädt die Daten einer Datenmenge aus einer Datei.

Mit LoadFromFile füllen Sie die Datenmenge mit in einer externen Datei gespeicherten Daten. Die Daten werden nicht in eine Datenbank verschoben, sie werden lediglich in den Speicher der Datenmenge im Arbeitsspeicher geladen.  

AFileName ist der Name der Datei mit den zu ladenden Daten. Wenn die Datei nicht vorhanden ist, wird eine Exception ausgelöst.  

AFormat ist das Dateiformat:

  • sfXML – eine wohlgeformte, eigenständige XML-Datei.
  • sfBinary – eine Binärdatei mit benutzerdefiniertem FireDAC-Format.
  • sfAuto – ein Format wird durch die Erweiterung von AFileName festgelegt: ".XML" – XML-Datei, ".ADB"/".BIN"/".DAT" * sfAuto – Binärdatei.
  • sfJSON – eine eigenständige JSON-Datei.

Wenn AFileName keine Erweiterung hat, wird das Format durch ResourceOptions.DefaultStoreExt, falls angegeben, bestimmt. Ansonsten wird es durch ResourceOptions.DefaultStoreFormat festgelegt.

Optional können Sie ResourceOptions.PersistentFileName angeben und Open aufrufen. Die Daten der Datenmenge werden dann aus der angegebenen Datei geladen. Beim Aufruf von Close werden die Daten zurückgespeichert, falls sie geändert wurden.  

AFileName muss Daten enthalten, die von einem vorausgehenden Aufruf dieser oder einer anderen SaveToFile-Methode in eine Datei gespeichert wurden. Nach dem Aufruf ist die Datenmenge aktiv.  

LoadFromFile versucht, aus der Datei die in ResourceOptions.StoreItems angegebenen Elemente zu laden. Wenn die Datei mit einem anderen StoreItems-Wert geschrieben wurde, wird eine Exception wie die folgende ausgelöst: 

  [FireDAC][Stan]-712 Cannot read [Relationlist] object

Beispiel

FDQuery1.Open('select * from customers');
FDQuery1.FetchAll;
FDQuery1.SaveToFile('c:\customers.xml', sfAuto);
....
FDMemTable1.LoadFromFile('c:\customers.xml', sfAuto);
FDMemTable1.Locate('CUSTOMER_ID', [100], []);

Siehe auch