Data.DB.TDataSet.GetFieldData

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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 */;

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
Data.DB.pas
Data.DB.hpp
Data.DB TDataSet


Beschreibung

Liest den aktuellen Wert eines Feldes in einen Puffer ein.

In den meisten Anwendungen muss GetFieldData nicht aufgerufen werden. TField-Objekten implementieren anhand dieser Methode ihre Methode GetData.

Die Parameter Field oder FieldNo geben das Feld an, dessen Daten gelesen werden sollen. Field ist die Komponente selbst, FieldNo seine Feldnummer. Mit dem Parameter Buffer wird ein Puffer mit ausreichend Speicherplatz für den Feldwert (unformatiert und nicht konvertiert) angegeben. NativeFormat gibt an, ob die Datenmenge das Feld im systemeigenen Format der IDE für den Feldtyp abruft. Wenn NativeFormat false ist, muss die Datenmenge den Feldwert in den nativen Typ konvertieren. Das Feld kann dann Daten unterschiedlicher Datenmengentypen (ADO-basiert usw.) in einer einheitlichen Form aufnehmen.

Der von GetFieldData zurückgegebene Wert gibt an, ob die Operation erfolgreich war.

Die Implementierung von GetFieldData in TDataSet gibt immer false zurück (es konnten keine Daten aus dem angegebenen Feld abgerufen werden). Diese Methode wird in abgeleiteten Klassen überschrieben, um Daten je nach Implementierung der Datenmenge abzurufen.

Hinweis: Die Methode TDataSet.GetFieldData erwartet Integer- und Cardinal-Werte anstelle von LongInt für ftInteger und LongWord für ftLongword.


Siehe auch