Data.DB.TDataSet.GetRecord

De RAD Studio API Documentation
Aller à : navigation, rechercher

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