Evénements connexion ADO
Remonter à Connexion à des stockages de données ADO
Outre les événements habituels qui se produisent pour tous les composants connexion de base de données, TADOConnection génère une série d'événements supplémentaires qui interviennent pendant le déroulement normal des opérations.
Sommaire
Evénements se produisant pendant l'établissement d'une connexion
Outre les événements BeforeConnect et AfterConnect, communs à tous les composants connexion de base de données, TADOConnection génère les événements OnWillConnect et OnConnectComplete lors de l'établissement d'une connexion. Ces événements se produisent après l'événement BeforeConnect.
- ADOdb.OnWillConnect se produit avant que le fournisseur ADO n'établisse une connexion. Il vous permet d'apporter des modifications de dernière minute à la chaîne de connexion, de fournir un nom et un mot de passe utilisateur si vous gérez votre propre support de connexion (login), d'imposer une connexion asynchrone ou même d'annuler la connexion avant son ouverture.
- ADOdb.OnConnectComplete se produit après l'ouverture de la connexion. Etant donné que TADOConnection peut représenter des connexions asynchrones, vous devez utiliser OnConnectComplete, qui se produit après l'ouverture de la connexion ou son échec en raison d'une condition d'erreur, au lieu de l'événement AfterConnect, qui se produit lorsque le composant connexion indique au fournisseur ADO d'ouvrir une connexion mais pas nécessairement après l'ouverture de la connexion.
Evénements se produisant pendant la déconnexion
Outre les événements BeforeDisconnect et AfterDisconnect, communs à tous les composants connexion de base de données, TADOConnection génère un événement ADOdb.OnDisconnect après la fermeture d'une connexion. OnDisconnect se produit après la fermeture de la connexion mais avant celle de tout ensemble de données associé et avant l'événement AfterDisconnect.
Evénements se produisant pendant la gestion des transactions
Les composants de connexion ADO proposent plusieurs événements pour gérer le cours d'un processus de transaction. Ces événements indiquent à quel moment un processus de transaction démarré par une méthode BeginTrans, CommitTrans et RollbackTrans a été correctement exécuté sur le stockage de données.
- L'événement ADOdb.OnBeginTransComplete se produit lorsque le stockage de données a correctement démarré une transaction après un appel de la méthode BeginTrans.
- L'événement ADOdb.OnCommitTransComplete se produit après la validation réussie d'une transaction à la suite de l'appel de CommitTrans.
- L'événement ADOdb.OnRollbackTransComplete se produit après l'annulation réussie d'une transaction à la suite de l'appel de RollbackTrans.
Autres événements
Les composants connexion ADO introduisent deux événements supplémentaires qui permettent de répondre aux notifications provenant de l'objet connexion ADO sous-jacent :
- L'événement ADOdb.OnExecuteComplete se produit après que le composant connexion exécute une commande sur le stockage de données (par exemple, après l'appel de la méthode Execute). OnExecuteComplete indique si l'exécution a réussi.
- L'événement ADOdb.OnInfoMessage se produit lorsque l'objet connexion sous-jacent fournit des informations détaillées après l'exécution d'une opération. Le gestionnaire d'événement OnInfoMessage reçoit l'interface d'un objet Error ADO qui contient les informations détaillées et un code d'état indiquant si l'opération a réussi.