Data.DB.TDataSet.GetFieldData

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function GetFieldData(Field: TField; var Buffer: TValueBuffer): Boolean; overload; virtual;
function GetFieldData(FieldNo: Integer; var Buffer: TValueBuffer): Boolean; overload; virtual;
function GetFieldData(Field: TField; var Buffer: TValueBuffer; NativeFormat: Boolean): Boolean; overload; virtual;
function GetFieldData(Field: TField; Buffer: Pointer): Boolean; overload; virtual; deprecated 'Use overloaded method instead';
function GetFieldData(FieldNo: Integer; Buffer: Pointer): Boolean; overload; virtual; deprecated 'Use overloaded method instead';
function GetFieldData(Field: TField; Buffer: Pointer; NativeFormat: Boolean): Boolean; overload; virtual; deprecated 'Use overloaded method instead';

C++

virtual bool __fastcall GetFieldData(TField* Field, System::DynamicArray<System::Byte> &Buffer)/* overload */;
virtual bool __fastcall GetFieldData(int FieldNo, System::DynamicArray<System::Byte> &Buffer)/* overload */;
virtual bool __fastcall GetFieldData(TField* Field, System::DynamicArray<System::Byte> &Buffer, bool NativeFormat)/* overload */;
virtual bool __fastcall GetFieldData _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (TField* Field, void * 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") (TField* Field, void * Buffer, bool NativeFormat)/* overload */;

Propriétés

Type Visibilité  Source Unité  Parent
function public
Data.DB.pas
Data.DB.hpp
Data.DB TDataSet


Description

Récupère la valeur en cours d'un 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 ou FieldNo indique le champ dont les données doivent être récupérées. Field spécifie le composant même, alors que FieldNo indique le numéro du champ. Le paramètre Buffer 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 l'EDI pour le type de champ. Lorsque NativeFormat vaut false, l'ensemble de données doit convertir la valeur du champ dans le type natif. Ceci permet au champ de gérer des données de différents types d'ensembles de données (ADO, etc.) d'une manière uniforme.

GetFieldData renvoie une valeur qui indique si les données ont été correctement récupérées.

Telle qu'implémentée dans TDataSet, GetFieldData renvoie toujours false, indiquant qu'aucune donnée n'a été récupérée à partir du champ spécifié. Les descendants redéfinissent cette méthode pour récupérer les données sous toute forme appropriée à l'implémentation de l'ensemble de données.

Remarque : La méthode TDataSet.GetFieldData attend des valeurs de type Integer et Cardinal au lieu de LongInt pour ftInteger et LongWord pour ftLongword.


Voir aussi