API:Data.SqlExpr.TCustomSQLDataSet.GetFieldData
Delphi
function GetFieldData(FieldNo: Integer; var Buffer: TValueBuffer): Boolean; overload; override;
function GetFieldData(Field: TField; var Buffer: TValueBuffer): Boolean; overload; override;
function GetFieldData(FieldNo: Integer; Buffer: Pointer): Boolean; overload; override; deprecated 'Use overloaded method instead';
function GetFieldData(Field: TField; Buffer: Pointer): Boolean; overload; override; deprecated 'Use overloaded method instead';
C++
virtual bool __fastcall GetFieldData(int FieldNo, System::DynamicArray<System::Byte> &Buffer)/* overload */;
virtual bool __fastcall GetFieldData(Data::Db::TField* Field, System::DynamicArray<System::Byte> &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") (Data::Db::TField* Field, void * Buffer)/* overload */;
inline bool __fastcall GetFieldData(Data::Db::TField* Field, System::DynamicArray<System::Byte> &Buffer, bool NativeFormat){ return Data::Db::TDataSet::GetFieldData(Field, Buffer, NativeFormat); }
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); }
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | Data.SqlExpr.pas Data.SqlExpr.hpp |
Data.SqlExpr | TCustomSQLDataSet |
Beschreibung
Liest den aktuellen Wert eines Feldes in einen Puffer ein.
Data.SqlExpr.TCustomSQLDataSet.GetFieldData erbt von Data.DB.TDataSet.GetFieldData. Der folgende Inhalt bezieht sich auf Data.DB.TDataSet.GetFieldData.
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.GetFieldDataerwartet Integer- und Cardinal-Werte anstelle von LongInt fürftIntegerund LongWord fürftLongword.