Datasnap.DBClient.TCustomClientDataSet.GetFieldData
Delphi
function GetFieldData(Field: TField; var Buffer: TValueBuffer): Boolean; overload; override;
function GetFieldData(FieldNo: Integer; var Buffer: TValueBuffer): Boolean; overload; override;
function GetFieldData(Field: TField; Buffer: Pointer): Boolean; overload; override; deprecated 'Use overloaded method instead';
function GetFieldData(FieldNo: Integer; Buffer: Pointer): Boolean; overload; override; deprecated 'Use overloaded method instead';
C++
virtual bool __fastcall GetFieldData(Data::Db::TField* Field, System::DynamicArray<System::Byte> &Buffer)/* overload */;
virtual bool __fastcall GetFieldData(int FieldNo, System::DynamicArray<System::Byte> &Buffer)/* overload */;
virtual bool __fastcall GetFieldData _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (Data::Db::TField* Field, void * Buffer)/* overload */;
virtual bool __fastcall GetFieldData _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (int FieldNo, 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 | Datasnap.DBClient.pas Datasnap.DBClient.hpp |
Datasnap.DBClient | TCustomClientDataSet |
Beschreibung
Ruft den aktuellen Wert eines Feldes ab.
Mit GetFieldData kann der Wert einer Feldkomponenten aus dem Datensatzpuffer abgerufen werden. TField-Objekte rufen GetFieldData auf, 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. Ist NativeFormat false, muss die Datenmenge den Feldwert mit der Methode Translate 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.