FireDAC.Comp.DataSet.TFDDataSet.SaveToFile
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 d'autres ensembles de données.
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
– un fichier binaire avec le format FireDAC personnalisé.sfAuto
-- le format est déterminé par l'extensionAFileName
: ".XML" - fichier XML, ".ADB" / ".BIN" / ".DAT" - fichier binaire.sfJSON
-- un fichier JSON autonome.
Si AFileName
n'a pas d'extension, le format est déterminé par ResourceOptions.DefaultStoreExt s'il est spécifié, ou sinon par ResourceOptions.DefaultStoreFormat.
Facultativement, 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éfini sur True
, l'extension du fichier original est changée en ResourceOptions.BackupExt, elle est enregistrée en ResourceOptions.BackupFolder, puis un nouveau fichier est ensuite créé.
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], []);