IBX.IBCustomDataSet.TIBCustomDataSet.GetFieldData

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

Delphi

function GetFieldData(Field: TField; Buffer: Pointer): Boolean; overload; override; deprecated;
function GetFieldData(Field : TField; var Buffer: TValueBuffer) : Boolean; overload; override;
function GetFieldData(Field: TField; var Buffer: TValueBuffer; NativeFormat: Boolean): Boolean; overload; override;

C++

virtual bool __fastcall GetFieldData _DEPRECATED_ATTRIBUTE0 (Data::Db::TField* Field, void * Buffer)/* overload */;
virtual bool __fastcall GetFieldData(Data::Db::TField* Field, System::DynamicArray<System::Byte> &Buffer)/* overload */;
virtual bool __fastcall GetFieldData(Data::Db::TField* Field, System::DynamicArray<System::Byte> &Buffer, bool NativeFormat)/* overload */;
inline bool __fastcall  GetFieldData(int FieldNo, System::DynamicArray<System::Byte> &Buffer){ return Data::Db::TDataSet::GetFieldData(FieldNo, Buffer); }
inline bool __fastcall  GetFieldData _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (int FieldNo, void * Buffer){ return Data::Db::TDataSet::GetFieldData(FieldNo, Buffer); }
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
IBX.IBCustomDataSet.pas
IBX.IBCustomDataSet.hpp
IBX.IBCustomDataSet TIBCustomDataSet


説明

フィールド データをバッファに読み込みます。

大抵のアプリケーションは、GetFieldData を呼び出す必要はありません。TField オブジェクトはこのメソッドを呼び出して、自分の GetData メソッドを実装します。

  • Field パラメータは、データがフェッチされるフィールドを示します。Field は、コンポーネントそのものを示しており、FieldNo は、そのフィールド番号を示しています。
  • Buffer パラメータは、フィールドの値を、データベース内に存在している状態のまま(未フォーマットおよび未変換で)受け入れるために、十分な容量を持つメモリ バッファです。
  • NativeFormat は、データセットがフィールドのフェッチする際、そのフィールドのタイプに対する Delphi のネイティブ形式でフェッチを行うかどうかを指定します。

NativeFormatFalse の場合、データセットはフィールドの値をネイティブのタイプに変換しなければなりません。 これによりフィールドは、違うタイプのデータセット(IBX ベース、BDE ベース、など)からのデータも、同じ方法で処理することができます

データの Buffer への書き込みが成功した場合に、GetFieldDataTrue を返します。

メモ:GetFieldData(Field: TField; Buffer: Pointer): Boolean; は、非推奨となっており、将来のリリースで削除が予定されています。Data.DB.TValueBuffer パラメータを取るオーバーロードを代わりに使用してください。