Data.DB.TField.GetData

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

Delphi

function GetData(var Buffer: TValueBuffer; NativeFormat: Boolean = True): Boolean; overload;
function GetData(Buffer: Pointer; NativeFormat: Boolean = True): Boolean; overload; deprecated 'Use overloaded method instead';

C++

bool __fastcall GetData(System::DynamicArray<System::Byte> &Buffer, bool NativeFormat = true)/* overload */;
bool __fastcall GetData _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (void * Buffer, bool NativeFormat = true)/* overload */;

プロパティ

種類 可視性 ソース ユニット
function public
Data.DB.pas
Data.DB.hpp
Data.DB TField


説明

このフィールドの未整形データを返します。

GetData を呼び出すと、フィールド内のデータをバッファに返します。GetData は、基本的には内部使用のためのものです。

バッファには、データのために割り当てられる十分なスペースがなければなりません。DataSize プロパティを使用すると、必要な領域を判断できます。

DisplayTextText、AsXXX の各プロパティとは異なり、GetData はデータを特定の型に変換しません。代わりに、基となるデータベース情報を反映した型を使用します(NativeFormat を false に設定していない限り)。NativeFormat は、未処理のデータベース情報が、データベース フィールドの特定の型と関連づけられた基となる型に変換されるべきかどうかを示します。NativeFormat が true の場合、データセットは素のデータベース情報を変換しません。NativeFormat が false の場合には、データセットは、フィールドに関連づけられている型に、フィールド値を変換する必要があります。

データが NULL の場合、GetData は false を返し、Buffer に転送されるデータはありません。そうでなければ、GetData は true を返します。

メモ: GetData は、BLOB やメモ フィールドからデータを呼び出すために、使用することはできません。BLOB データを読み出すには、データセットの CreateBlobStream メソッド、または BLOB フィールドのp SaveToStream メソッドによって返されるストリームを使用します。

関連項目

コード サンプル