Data.DB.TDataSet.GetFieldData

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

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 値を前提します。


関連項目