FireDAC.Comp.DataSet.TFDDataSet.LoadFromFile

提供: RAD Studio API Documentation
移動先: 案内検索

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

プロパティ

種類 可視性 ソース ユニット
procedure
function
public
FireDAC.Comp.DataSet.pas
FireDAC.Comp.DataSet.hpp
FireDAC.Comp.DataSet TFDDataSet


説明

データセットのデータをファイルからロードします。

LoadFromFile を使用すると、データセットを、外部ファイル内に格納されているデータで設定できます。 データはデータベースへ移されず、メモリ ストレージ内のデータセットへロードされます。 

AFileName は、ロードするデータを格納するファイルの名前です。 そのファイルが存在しなければ、例外が発生します。 

AFormat はファイル形式で:

  • sfXML – 整形スタンドアロン XML ファイル。
  • sfBinary – カスタム FireDAC 形式のバイナリ ファイル。
  • sfAuto – 形式は AFileName 拡張子によって決定されます: ".XML" - XML ファイル、".ADB" / ".BIN" / ".DAT" * sfAuto – バイナリ ファイル。
  • sfJSON – スタンドアロン JSON ファイル。

AFileName に拡張子がない場合、形式は、ResourceOptions.DefaultStoreExt が指定されているならそれによって決定されます。 そうでなければ、ResourceOptions.DefaultStoreFormat によって決定されます。

任意で、ResourceOptions.PersistentFileName を指定して Open を呼出すと、データセット データは指定されたファイルからロードされます。Close を呼び出すと、データが修正された場合、それは再び保存されます。 

AFileName は、このメソッドへの以前の呼出し、またはクライアント データセットの SaveToFile メソッドによって、ファイルに保存されたデータを格納しなければなりません。呼出しの後、データセットはアクティブになります。 

LoadFromFile は、ResourceOptions.StoreItems で指定された項目を、ファイルから読み込みます。. ファイルが別の StoreItems 値で書き込まれている場合、次の例外が発生します: 

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

例:

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

関連項目