FireDAC.Comp.DataSet.TFDDataSet.SaveToFile

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

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

C++

void __fastcall SaveToFile(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

Speichert die Daten einer Datenmenge in einer Datei.

Mit SaveToFile schreiben Sie die Daten einer Datenmenge in eine externe Datei zur späteren Verwendung durch diese oder andere Datenmengen.  

AFileName gibt den Namen der externen Datei an, in die die Daten gespeichert werden sollen.  

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" – Binärdatei.
  • sfJSON – eine eigenständige JSON-Datei.

Wenn AFileName keine Erweiterung hat, dann wird das Format durch ResourceOptions.DefaultStoreExt bestimmt, falls angegeben, ansonsten durch ResourceOptions.DefaultStoreFormat.

Optional können Sie ResourceOptions.PersistentFileName vor dem Aufruf von Open angeben. In diesem Fall werden Daten beim Schließen (Close) in die Datei gespeichert, falls Daten geändert wurden oder die Datei nicht vorhanden ist.  

Wenn die Datei vorhanden ist und ResourceOptions.Backup auf True gesetzt ist, dann wird die ursprüngliche Dateierweiterung in ResourceOptions.BackupExt geändert, die Datei im ResourceOptions.BackupFolder gespeichert und dann eine neue Datei geschrieben. 

SaveToFile speichert die in ResourceOptions.StoreItems angegebenen Elemente in der Datei.

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