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 verlagert, sie werden nur 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 – die Datei ist eine wohlgeformte, eigenständige XML-Datei.
  • sfBinary – die Datei ist eine Binärdatei mit benutzerdefiniertem FireDAC-Format.
  • sfAuto – das Format wird durch die AFileName-Erweiterung bestimmt: ".XML" – XML-Datei, ".ADB"/".BIN"/".DAT" – Binärdatei. Wenn AFileName keine Erweiterung hat, wird das Format durch ResourceOptions.DefaultStoreExt festgelegt, sofern angegeben. Ansonsten wird es durch ResourceOptions.DefaultStoreFormat festgelegt.

Optional können Sie ResourceOptions.PersistentFileName angeben und Open aufrufen, und die Datenmengendaten werden 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 Datenmeng 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 die folgende Exception 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