FireDAC.Comp.DataSet.TFDDataSet.SaveToFile

De RAD Studio API Documentation
Aller à : navigation, rechercher

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));

Propriétés

Type Visibilité  Source Unité  Parent
procedure
function
public
FireDAC.Comp.DataSet.pas
FireDAC.Comp.DataSet.hpp
FireDAC.Comp.DataSet TFDDataSet

Description

Enregistre les données d'un ensemble de données dans un fichier.

Utilisez SaveToFile pour écrire les données d'un ensemble de données dans un fichier externe en vue de leur utilisation ultérieure par cet ensemble de données ou un autre.

AFileName est le nom du fichier externe dans lequel enregistrer les données.

AFormat est le format du fichier :

  • sfXML -- fichier XML autonome correctement formé.
  • sfBinary -- fichier binaire avec le format FireDAC personnalisé.
  • sfAuto -- le format est déterminé par l'extension AFileName : ".XML" - fichier XML, ".ADB" / ".BIN" / ".DAT" - fichier binaire. Si AFileName n'a pas d'extension, le format est déterminé par ResourceOptions.DefaultStoreExt s'il est spécifié. Sinon, il est déterminé par ResourceOptions.DefaultStoreFormat.

Eventuellement, vous pouvez spécifier ResourceOptions.PersistentFileName avant d'appeler Open. Dans ce cas, les données sont enregistrées dans le fichier au moment de l'exécution de Close, si les données ont été modifiées ou si le fichier n'existe pas.

Si le fichier existe et que ResourceOptions.Backup est définie sur True, l'extension du fichier d'origine est remplacée par ResourceOptions.BackupExt, le fichier est enregistré dans ResourceOptions.BackupFolder, puis un nouveau fichier est écrit.

SaveToFile stocke dans le fichier les éléments spécifiés par ResourceOptions.StoreItems.

Exemple

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

Voir aussi