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

Optional können Sie ResourceOptions.PersistentFileName vor dem Aufruf von Open festlegen. 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 in ResourceOptions.BackupFolder gespeichert und dann eine neue Datei angelegt.

SaveToFile speichert die in ResourceOptions.StoreItems angegebenen Elemente in die 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