Data.DB.TDataSet.GetRecord
Delphi
function GetRecord(Buffer: TRecBuf; GetMode: TGetMode; DoCheck: Boolean): TGetResult; overload; virtual; {$IFDEF NEXTGEN}abstract;{$ENDIF NEXTGEN}
function GetRecord(Buffer: TRecordBuffer; GetMode: TGetMode; DoCheck: Boolean): TGetResult; overload; virtual; abstract;
C++
virtual TGetResult __fastcall GetRecord(NativeInt Buffer, TGetMode GetMode, bool DoCheck)/* overload */;
virtual TGetResult __fastcall GetRecord(System::PByte Buffer, TGetMode GetMode, bool DoCheck) = 0 /* overload */;
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | protected | Data.DB.pas Data.DB.hpp |
Data.DB | TDataSet |
Description
Passe à l'enregistrement spécifié.
Utilisez GetRecord pour obtenir l'enregistrement spécifié par le paramètre GetMode.
Le paramètre Buffer est un pointeur sur l'emplacement mémoire représentant le tampon d'enregistrement.
Le paramètre GetMode spécifie le mode de récupération de l'enregistrement et peut prendre les valeurs suivantes :
| Valeur | Description |
|---|---|
|
gmCurrent |
L'enregistrement en cours sera récupéré. |
|
gmNext |
L'enregistrement suivant celui en cours sera récupéré. |
|
gmPrior |
L'enregistrement précédant celui en cours sera récupéré. |
Lorsque le paramètre DoCheck a la valeur True, la méthode signale si une erreur se produit lors de la tentative de récupération des données de l'enregistrement en cours et renvoie grError.
Cette méthode renvoie une valeur TGetResult avec la signification suivante :
| Valeur | Description |
|---|---|
|
grOK |
Aucune erreur n'est apparue lors de la tentative de récupération des données de l'enregistrement en cours. |
|
grBOF |
L'indicateur de début de fichier est renvoyé quand l'ensemble de données est situé au début du fichier. |
|
grEOF |
L'indicateur de fin de fichier est renvoyé quand l'ensemble de données est situé à la fin du fichier. |
|
grError |
Une erreur est apparue lors de la tentative de récupération des données de l'enregistrement en cours. |
Remarque : Cette méthode est abstraite. Tous les ensembles de données doivent la redéfinir en fonction de leurs besoins.
Voir aussi