Data.DB.TDataSet.GetFieldData
Delphi
function GetFieldData(Field: TField; Buffer: Pointer): Boolean; overload; virtual; function GetFieldData(FieldNo: Integer; Buffer: Pointer): Boolean; overload; virtual; function GetFieldData(Field: TField; Buffer: Pointer; NativeFormat: Boolean): Boolean; overload; virtual;
C++
virtual bool __fastcall GetFieldData(TField* Field, void * Buffer)/* overload */; virtual bool __fastcall GetFieldData(int FieldNo, void * Buffer)/* overload */; virtual bool __fastcall GetFieldData(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 braucht GetFieldData nicht aufgerufen zu werden. Die Methode wird von TField-Objekten verwendet, um ihre Methode GetData zu implementieren.
Die Parameter Field oder FieldNo geben das Feld an, dessen Daten gelesen werden. Field ist die Komponente selbst, FieldNo seine Nummer. 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 nativen IDE-Format des jeweiligen Feldtyps abruft. Wenn der Parameter false ist, muss die Datenmenge den Feldwert in den nativen Typ konvertieren. Dadurch kann das Feld Daten aus unterschiedlichen Datenmengentypen (ADO-basiert, BDE-basiert usw.) auf dieselbe Art und Weise behandeln.
Der von GetFieldData zurückgegebene Wert zeigt an, ob die Operation erfolgreich war.
Die Implementierung der Methode in TDataSet gibt immer false zurück (es konnten keine Daten abgerufen werden). Sie wird in abgeleiteten Klassen überschrieben, um Informationen je nach Implementierung der Datenmenge abzurufen.