FireDAC.Comp.DataSet.TFDDataSet.LoadFromFile
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));
Inhaltsverzeichnis
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 vonAFileName
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], []);