FireDAC.Comp.DataSet.TFDDataSet.GetFieldData
Delphi
function GetFieldData(AFieldNo: Integer; var ABuffer: TValueBuffer): Boolean; overload; override;
function GetFieldData(AField: TField; var ABuffer: TValueBuffer): Boolean; overload; override;
C++
virtual bool __fastcall GetFieldData(int AFieldNo, System::DynamicArray<System::Byte> &ABuffer)/* overload */;
virtual bool __fastcall GetFieldData(Data::Db::TField* AField, System::DynamicArray<System::Byte> &ABuffer)/* 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){ return Data::Db::TDataSet::GetFieldData(Field, 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); }
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | FireDAC.Comp.DataSet.pas FireDAC.Comp.DataSet.hpp |
FireDAC.Comp.DataSet | TFDDataSet |
Beschreibung
Liest den aktuellen Wert eines Feldes in einen Puffer ein.
FireDAC.Comp.DataSet.TFDDataSet.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.