Data.DB.TField.GetData
Delphi
function GetData(Buffer: Pointer; NativeFormat: Boolean = True): Boolean; overload;
C++
bool __fastcall GetData(void * Buffer, bool NativeFormat = true)/* overload */;
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | Data.DB.pas Data.DB.hpp |
Data.DB | TField |
Description
Renvoie les données du champ non formatées.
La méthode GetData renvoie dans un tampon les données d'un champ. GetData est destinée à des besoins internes.
L'espace alloué à Buffer doit être suffisamment grand pour contenir les données. La propriété DataSize permet de connaître l'espace nécessaire.
A la différence des propriétés DisplayText, Text et AsXXX, GetData ne traduit pas les données dans un type spécifique. A la place, elle utilise un type qui reflète les informations de base de données sous-jacentes à moins que vous n'affectiez la valeur false à NativeFormat. NativeFormat indique si les informations de base de données brutes doivent être traduites dans le type sous-jacent associé au type spécifique du champ base de données. Lorsque NativeFormat a la valeur true, l'ensemble de données ne convertit pas les informations de base de données brutes. Quand NativeFormat a la valeur false, l'ensemble de données doit traduire la valeur champ dans le type associé au champ.
Si les données contiennent NULL, GetData renvoie false et rien n'est transféré dans Buffer. Sinon, GetData renvoie true.
Remarque : GetData ne peut être utilisée pour lire les données des champs BLOB ou mémo. Pour lire les données BLOB, utilisez le flux renvoyé par la méthode CreateBlobStream de l'ensemble de données ou la méthode SaveToStream du champ BLOB.