Data.Win.ADODB.TCustomADODataSet.OnEndOfRecordset

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property OnEndOfRecordset: TEndOfRecordsetEvent read FOnEndOfRecordset write FOnEndOfRecordset;

C++

__property TEndOfRecordsetEvent OnEndOfRecordset = {read=FOnEndOfRecordset, write=FOnEndOfRecordset};

Propriétés

Type Visibilité  Source Unité  Parent
event published
Data.Win.ADODB.pas
Data.Win.ADODB.hpp
Data.Win.ADODB TCustomADODataSet

Description

Se produit quand le pointeur de ligne d'un ensemble d'enregistrements est déplacé après la dernière ligne.

Ecrivez un gestionnaire d'événement OnEndOfRecordset pour effectuer des actions spécifiques après une tentative de changer de ligne après la dernière ligne de l'ensemble d'enregistrements. Aucune méthode de déplacement ne devrait déclencher cet événement en raison des effets de la propriété Eof. Cet événement ne peut être déclenché que par des opérations internes de déplacement dans l'ensemble d'enregistrements ou par un accès direct à l'objet Recordset (via la propriété Recordset du composant ensemble de données).

DataSet est le composant ensemble de données ADO qui a déclenché l'événement OnEndOfRecordset. Ce composant ensemble de données contient également l'ensemble d'enregistrements en question.

MoreData est une valeur booléenne qui indique s'il existe des lignes non lues au-delà de la dernière ligne lue avant l'événement OnEndOfRecordset.

La valeur EventStatus (EventStatusEnum ADO) indique le succès ou l'échec de l'exécution de l'opération qui a déclenché cet événement.

Remarque :  : Un pointeur de ligne de l'objet Recordset est distinct du pointeur d'enregistrement de son composant ensemble de données ADO. Il est possible que l'objet Recordset ADO génère des événements de déplacement de ligne sans que le composant ensemble de données ADO génère des événements BeforeScroll ou AfterScroll. Cela peut être dû à la mise à jour en arrière-plan et à la resynchronisation des enregistrements quand les données sont modifiées. L'événement OnEndOfRecordset est purement un événement de l'objet Recordset qui est indépendant de tous les événements de navigation d'enregistrements du composant ensemble de données.