Événements des objets ADP Connection et Recordset

Deux objets ADO peuvent déclencher des événements, à savoir l’objet Connection et l’objet Recordset. La famille ConnectionEvent a trait aux opérations sur l’objet Connection, et la famille RecordsetEvent aux opérations sur l’objet Recordset.

• Événements d’objet Connection : des événements sont émis quand une transaction sur une connexion commence, est validée ou est annulée ; quand un objet Command s’exécute ; quand un avertissement se produit pendant une opération Connection Event ; ou quand un objet Connection démarre ou se termine.

• Événements d’objet Recordset : des événements sont émis autour d’opérations d’extraction asynchrones, ainsi que quand vous parcourez les lignes d’un objet Recordset, modifiez un champ dans une ligne d’un objet Recordset, modifiez une ligne dans un objet Recordset, ouvrez un objet Recordset avec un curseur côté serveur, fermez un objet Recordset, ou apportez une modification quelconque à un objet Recordset.

Les tableaux suivants résument les événements et leurs descriptions.

ConnectionEvent	Description
BeginTransComplete, CommitTransComplete, RollbackTransComplete	Gestion de transaction : notification indiquant que la transaction active sur la connexion a démarré, a été validée ou a été annulée.
WillConnect, ConnectComplete, Disconnect	Gestion de connexion : notification indiquant que la connexion active va démarrer, a démarré ou est terminée.
WillExecute, ExecuteComplete	Gestion d’exécution de commande : notification indiquant que l’exécution de la commande active sur la connexion va démarrer ou est terminée.
InfoMessage	Information : notification indiquant qu’il existe des informations supplémentaires sur l’opération actuelle.

RecordsetEvent	Description
FetchProgress, FetchComplete	État de récupération : notification de la progression ou de la fin d’une opération d’extraction de données. Ces événements ne sont disponibles que si l’objet Recordset a été ouvert à l’aide d’un curseur côté client.
WillChangeField, FieldChangeComplete	Gestion de modification de champ : notification indiquant que la valeur du champ actif va changer ou a changé.
WillMove, MoveComplete, EndOfRecordset	Gestion de la navigation : notification indiquant que la position de ligne active dans un objet Recordset va changer, a changé ou a atteint la fin de l’objet Recordset.
WillChangeRecord, RecordChangeComplete	Gestion de modification de ligne : notification indiquant que quelque chose dans la ligne active de l’objet Recordset va changer ou a changé.
WillChangeRecordset, RecordsetChangeComplete	Gestion de modification d’objet Recordset : notification indiquant que quelque chose dans l’objet Recordset actif va changer ou a changé.

Voir aussi

Instanciation des événements ADO par langageÉvénements ADOParamètres des événementsFonctionnement conjoint des gestionnaires d’événementsTypes d’événements