API:SimpleDS.TSimpleDataSet.FileName
Delphi
property FileName;
C++
__property FileName = {default=0};
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
property | published | SimpleDS.pas SimpleDS.hpp |
SimpleDS | TSimpleDataSet |
説明
クライアントデータセットのデータを格納するファイルを指定します。
SimpleDS.TSimpleDataSet.FileName は Datasnap.DBClient.TCustomClientDataSet.FileName を継承しています。以下の内容はすべて Datasnap.DBClient.TCustomClientDataSet.FileName を参照しています。
クライアントデータセットのデータを格納するファイルを指定します。
FileName プロパティは,クライアントデータセットが常に単一のファイルに対してデータを読み書きする場合に設定します。FileName が有効なファイル名の場合,クライアントデータセットは,そのファイルを閉じたときに自動的にデータを書き込みます。FileName が既存のファイル名を指定している場合,クライアントデータセットは,そのファイルを開いたときに自動的にデータを読み込みます。
変更は,ファイルの保存時にデータにマージされるわけではありません。これは,「ブリーフケース」モデルを使用するアプリケーションが FileName を設定する際に,データベースサーバーに送られる更新が失われることを防ぐためのものです。単層アプリケーションは,データセットを閉じてデータをディスクに保存する前に明示的に変更をマージしなければなりません。
メモ: クライアントデータセットは,データをファイルに書き込む際にファイルの内容を上書きします。ファイルの以前の内容は失われます。
別のファイルに対して読み書きするには,LoadFromFile メソッドおよび SaveToFile メソッドをかわりに使用します。これらのメソッドは,Active プロパティが変更されたとき以外の場合にデータをロードおよび保存するのにも使用できます。