API:Datasnap.DBClient.TCustomClientDataSet.GetFieldData
Delphi
function GetFieldData(Field: TField; var Buffer: TValueBuffer): Boolean; overload; override;
function GetFieldData(FieldNo: Integer; var Buffer: TValueBuffer): Boolean; overload; override;
function GetFieldData(Field: TField; Buffer: Pointer): Boolean; overload; override; deprecated 'Use overloaded method instead';
function GetFieldData(FieldNo: Integer; Buffer: Pointer): Boolean; overload; override; deprecated 'Use overloaded method instead';
C++
virtual bool __fastcall GetFieldData(Data::Db::TField* Field, System::DynamicArray<System::Byte> &Buffer)/* overload */;
virtual bool __fastcall GetFieldData(int FieldNo, System::DynamicArray<System::Byte> &Buffer)/* overload */;
virtual bool __fastcall GetFieldData _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (Data::Db::TField* Field, void * Buffer)/* overload */;
virtual bool __fastcall GetFieldData _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (int FieldNo, void * Buffer)/* overload */;
inline bool __fastcall GetFieldData(Data::Db::TField* Field, System::DynamicArray<System::Byte> &Buffer, bool NativeFormat){ return Data::Db::TDataSet::GetFieldData(Field, Buffer, NativeFormat); }
inline bool __fastcall GetFieldData _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (Data::Db::TField* Field, void * Buffer, bool NativeFormat){ return Data::Db::TDataSet::GetFieldData(Field, Buffer, NativeFormat); }
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
| function | public | Datasnap.DBClient.pas Datasnap.DBClient.hpp |
Datasnap.DBClient | TCustomClientDataSet |
説明
フィールドの現在の値をバッファに取り出します。
Datasnap.DBClient.TCustomClientDataSet.GetFieldData は Data.DB.TDataSet.GetFieldData を継承しています。以下の内容はすべて Data.DB.TDataSet.GetFieldData を参照しています。
フィールドの現在の値をバッファに取り出します。
ほとんどのアプリケーションでは、GetFieldData を呼び出す必要はありません。TField オブジェクトが、その GetData メソッドの実装の中でこのメソッドを呼び出します。
Field または FieldNo のパラメータは、どのフィールドのデータを取得するかを示します。Field はコンポーネント自体を、FieldNo はそのフィールド番号を示します。Buffer パラメータは、データベース内に存在するフィールドの値（書式設定や変換が行われていないもの）を受け取るだけの十分な容量のあるメモリ バッファです。NativeFormat は、データセットがフィールドを取得するときに、そのフィールド型に割り当てられた IDE のネイティブ形式で取得するかどうかを示します。NativeFormat が false の場合には、データセットでフィールド値をネイティブ型に変換する必要があります。そうすることで、各フィールドでは、異なる種類のデータセット（ADO ベースなど）のデータを統一した方法で処理できるようになります。
GetFieldData は、データの取得が成功したかどうかを示す値を返します。
TDataSet で実装された GetFieldData は常に false を返しますが、これは、指定されたフィールドからデータを取得できなかったことを示します。下位クラスでは、そのデータセットの実装に適した方法でデータを取得するよう、このメソッドをオーバーライドします。
TDataSet.GetFieldData メソッドは、ftInteger に対して LongInt、ftLongword に対して LongWord の代わりに、Integer 値および Cardinal 値を前提します。