FireDAC.Comp.DataSet.TFDDataSet.LoadFromFile

De RAD Studio API Documentation
Aller à : navigation, rechercher

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

Propriétés

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


Description

Charge les données d'un ensemble de données à partir d'un fichier.

Utilisez LoadFromFile pour remplir l'ensemble de données avec les données stockées dans un fichier externe. Les données ne sont pas déplacées dans une base de données, elles sont juste chargées dans un stockage en mémoire d'ensemble de données. 

AFileName est le nom du fichier contenant les données à charger. Si le fichier n'existe pas, une exception est déclenchée. 

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'extension AFileName : ".XML" - fichier XML, ".ADB" / ".BIN" / ".DAT" * sfAuto – 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é. Sinon, il est déterminé par ResourceOptions.DefaultStoreFormat.

Facultativement, vous pouvez spécifier ResourceOptions.PersistentFileName avant d'appeler Open et les données de l'ensemble de données sont chargées à partir du fichier spécifié. Lors de l'appel de Close, elles sont réenregistrées si les données ont été modifiées. 

AFileName doit contenir les données enregistrées dans un fichier par un appel préalable à la méthode SaveToFile de cet ensemble de données client ou d'un autre. Après l'appel, l'ensemble de données est actif. 

LoadFromFile essaie de charger à partir du fichier les éléments spécifiés par ResourceOptions.StoreItems. Si le fichier a été écrit avec une valeur StoreItems différente, l'exception suivante est déclenchée : 

  [FireDAC][Stan]-712 Cannot read [Relationlist] object

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