É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