IBX.IBCustomDataSet.TIBCustomDataSet.GetFieldData

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function GetFieldData(Field: TField; Buffer: Pointer): Boolean; overload; override; deprecated;
function GetFieldData(Field : TField; var Buffer: TValueBuffer) : Boolean; overload; override;
function GetFieldData(Field: TField; var Buffer: TValueBuffer; NativeFormat: Boolean): Boolean; overload; override;

C++

virtual bool __fastcall GetFieldData _DEPRECATED_ATTRIBUTE0 (Data::Db::TField* Field, void * Buffer)/* overload */;
virtual bool __fastcall GetFieldData(Data::Db::TField* Field, System::DynamicArray<System::Byte> &Buffer)/* overload */;
virtual bool __fastcall GetFieldData(Data::Db::TField* Field, System::DynamicArray<System::Byte> &Buffer, bool NativeFormat)/* overload */;
inline bool __fastcall  GetFieldData(int FieldNo, System::DynamicArray<System::Byte> &Buffer){ return Data::Db::TDataSet::GetFieldData(FieldNo, 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); }

Propriétés

Type Visibilité  Source Unité  Parent
function public
IBX.IBCustomDataSet.pas
IBX.IBCustomDataSet.hpp
IBX.IBCustomDataSet TIBCustomDataSet

Description

Lit les données du champ dans un tampon.

La plupart des applications n'ont pas besoin d'appeler GetFieldData. Les objets TField appellent cette méthode pour implémenter leur méthode GetData.

  • Le paramètre Field indique le champ dont les données doivent être récupérées. Field spécifie le composant lui-même, tandis que FieldNo indique son numéro de champ.
  • Le paramètre Tampon est un tampon mémoire ayant suffisamment d'espace pour accepter la valeur du champ tel qu'il existe dans la base de données (non formaté et non traduit).
  • NativeFormat indique si l'ensemble de données récupère le champ dans le format natif de Delphi pour le type de champ.

Lorsque NativeFormat vaut False, l'ensemble de données doit convertir la valeur champ dans le type natif. Ceci permet au champ de gérer des données de différents types d'ensembles de données (IBX, BDE, et ainsi de suite) d'une manière uniforme.

GetFieldData renvoie True si les données ont été correctement écrites dans Buffer.

Remarque : GetFieldData(Field: TField; Buffer: Pointer): Boolean; est obsolète et sera retiré dans les prochaines versions. Utilisez à la place la surcharge qui prend un paramètre Data.DB.TValueBuffer.