Événements de connexion et d’recordset ADO
Deux objets ADO peuvent déclencher des événements : l’objet Connection et l’objet Recordset. La famille ConnectionEvent se rapporte aux opérations sur l’objet Connection, et la famille RecordsetEvent concerne les opérations sur l’objet Recordset.
événements de connexion: les événements sont émis lorsqu’une transaction commence, est validée ou restaurée ; lorsqu’une commande s’exécute ; lorsqu’un avertissement se produit pendant une opération Connection Event ; ou lorsqu’une connexion démarre ou se termine.
Recordset Events: les événements sont émis autour des opérations d’extraction asynchrones, ainsi que lorsque vous parcourez les lignes d’un objet Recordset, modifiez un champ dans une ligne d'Recordset, modifiez une ligne dans un jeu d’enregistrements , ouvrez un jeu d’enregistrements avec un curseur côté serveur, fermez un Recordset, ou apportez une modification quelconque dans le jeu d’enregistrements .
Les tableaux suivants résument les événements et leurs descriptions.
| ÉvénementDeConnexion | Description |
|---|---|
| DébutTransComplet, ValidationTransComplet, AnnulationTransComplet | Gestion des transactions : notification indiquant que la transaction actuelle sur la connexion a démarré, a été validée ou annulée. |
| ConnexionPrévue, ConnexionComplète, Déconnexion | gestion des connexions : notification indiquant que la connexion actuelle démarre, a démarré ou s’est terminée. |
| WillExecute, ExecuteComplete | gestion de l’exécution des commandes : notification indiquant que l’exécution de la commande actuelle sur la connexion démarre ou s’est terminée. |
| Message d'information | Informationnel - Notification indiquant qu’il y a des informations supplémentaires sur l’opération en cours. |
| RecordsetEvent | Description |
|---|---|
| FetchProgress, FetchComplete | état de récupération : notification de la progression d’une opération de récupération de données ou de la fin de l’opération de récupération. Ces événements sont disponibles uniquement si le jeu d’enregistrements a été ouvert à l’aide d’un curseur côté client. |
| WillChangeField, FieldChangeComplete | gestion des modifications de champ : notification indiquant que la valeur du champ actuel change ou a changé. |
| WillMove, MoveComplete, EndOfRecordset | Gestion de la navigation - Notification indiquant que la position de ligne actuelle dans un jeu d'enregistrements va changer, a changé ou a atteint la fin du jeu d'enregistrements . |
| WillChangeRecord, RecordChangeComplete | gestion des modifications de ligne : notification indiquant que quelque chose dans la ligne actuelle du jeu d’enregistrements changera ou a changé. |
| WillChangeRecordset, RecordsetChangeComplete | Recordset Change Management, notification indiquant que quelque chose dans le Recordset actuel change ou a changé. |
Voir aussi
instanciation d’événements ADO par langageévénements ADOparamètres d’événementcomment les gestionnaires d’événements fonctionnent ensembletypes d’événements