Data.DB.TDataSet.GetFieldData
Delphi
function GetFieldData(Field: TField; var Buffer: TValueBuffer): Boolean; overload; virtual;
function GetFieldData(FieldNo: Integer; var Buffer: TValueBuffer): Boolean; overload; virtual;
function GetFieldData(Field: TField; var Buffer: TValueBuffer; NativeFormat: Boolean): Boolean; overload; virtual;
function GetFieldData(Field: TField; Buffer: Pointer): Boolean; overload; virtual; deprecated 'Use overloaded method instead';
function GetFieldData(FieldNo: Integer; Buffer: Pointer): Boolean; overload; virtual; deprecated 'Use overloaded method instead';
function GetFieldData(Field: TField; Buffer: Pointer; NativeFormat: Boolean): Boolean; overload; virtual; deprecated 'Use overloaded method instead';
C++
virtual bool __fastcall GetFieldData(TField* Field, System::DynamicArray<System::Byte> &Buffer)/* overload */;
virtual bool __fastcall GetFieldData(int FieldNo, System::DynamicArray<System::Byte> &Buffer)/* overload */;
virtual bool __fastcall GetFieldData(TField* Field, System::DynamicArray<System::Byte> &Buffer, bool NativeFormat)/* overload */;
virtual bool __fastcall GetFieldData _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (TField* Field, void * Buffer)/* overload */;
virtual bool __fastcall GetFieldData _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (int FieldNo, void * Buffer)/* overload */;
virtual bool __fastcall GetFieldData _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (TField* Field, void * Buffer, bool NativeFormat)/* overload */;
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
| function | public | Data.DB.pas Data.DB.hpp |
Data.DB | TDataSet |
説明
フィールドの現在の値をバッファに取り出します。
ほとんどのアプリケーションでは、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 値を前提します。