FireDAC.Comp.DataSet.TFDDataSet.Dataのソースを表示

{{#lst:API:FireDAC.Comp.DataSet.TFDDataSet.Data|api}}
==説明==
{{#ifeq: {{PAGENAME}} | FireDAC.Comp.DataSet.TFDDataSet.Data | |{{InheritsFrom|FireDAC.Comp.DataSet.TFDDataSet.Data}}}}

<section begin="short" />
データセットのデータを表します。これを使ってデータセットからデータセットへデータを完全にコピーすることができます。
<section end="short" />

[[FireDAC.Comp.DataSet.TFDDataSet.Data|Data]] プロパティは、データセットのインメモリの内部データ記憶域を表します。アプリケーションでは、このプロパティを使用して、FireDAC データセットから別の FireDAC データセットへと、現在の構造およびデータをコピーすることができます。

プロパティの値は '''IFDDataSet''' インターフェイスの参照です。参照カウントが行われているため、アプリケーションでこれを明示的に解放する必要はありません。アプリケーションで変数またはフィールドを使ってインターフェイスの参照を保持している場合には、データセットを閉じる前に参照を解放する必要があります。

このプロパティの値を設定するときは、データセットが非アクティブでなければなりません。アクティブであれば例外が発生します。設定が終わると、'''Self''' データセットは次の状態になります。
* [[FireDAC.Comp.DataSet.TFDDataSet.Indexes|Indexes]]、[[FireDAC.Comp.DataSet.TFDDataSet.IndexDefs|IndexDefs]]、Filter などを除いて、元のデータセットの構造になっています。
* すべての行のバージョンや状態（挿入済み、削除済み、更新済み、変更なし）も含めて、元のデータセットのデータのコピーが含まれています。
* 元のデータセットに未適用の変更が含まれていた場合には、[[FireDAC.Comp.DataSet.TFDDataSet.CachedUpdates|CachedUpdates]] が '''True''' になっています。
* 開いています。

===例===
<source lang="delphi">
 FDQuery1.SQL.Text := 'select * from orders; select * from customers';
 
 FDQuery1.Open;
 FDQuery1.FetchAll;
 // assign orders records to FDMemTable1
 FDMemTable1.Data := FDQuery1.Data;
 
 FDQuery1.NextRecordSet;
 FDQuery1.FetchAll;
 // assign customers records to FDMemTable2
 FDMemTable2.Data := FDQuery1.Data;
</source>

===関連項目===
* [[FireDAC.Comp.DataSet.TFDDataSet.Delta]]
* [[FireDAC.Comp.DataSet.TFDDataSet.FilteredData]]
* [[FireDAC.Comp.DataSet.TFDDataSet.CopyDataSet]]
* [[FireDAC.Comp.DataSet.TFDDataSet.CachedUpdates]]

[[Category:API ドキュメント]]
[[Category:XE5]]