Événements WillConnect, ConnectComplete et Disconnect de ADO

Définition et utilisation

Les événements sont des sous-programmes automatiquement appelés après qu'une opération spécifique ait été effectuée.

  • L'événement WillConnect est déclenché avant le début de la connexion.
  • L'événement ConnectComplete est déclenché après le début de la connexion.
  • L'événement Disconnect est déclenché à la fin de la connexion.

Syntaxe

WillConnect ConnectionString,userid,psword,options,status,objcon
Événement ConnectComplete objerror,status,objconn
Statut de déconnexion,objconn
Paramètres Description
ConnectionString Une chaîne de caractères contenant les informations utilisées pour la connexion.
userid Une chaîne de caractères contenant le nom d'utilisateur utilisé pour la connexion.
psword Une chaîne de caractères contenant le mot de passe utilisé pour la connexion.
options Valeur Long, indiquant la manière dont le fournisseur calcule la chaîne de connexion. L'option unique est adAsyncOpen.
objerror

L'objet Error contient les erreurs qui se sont produites.

Remarque :EventStatusEnum La valeur doit être définie sur adStatusErrorsOccurred pour créer l'objet Error.

status

Un EventStatusEnum Valeur. La valeur par défaut est adStatusOK.

Lorsque ConnectComplete est appelé, si l'événement WillConnect demande d'annuler la connexion en suspens, ce paramètre est défini sur adStatusCancel.

objconn Appliquer cet événement à l'objet Connection.

Valeur de EventStatusEnum

Constante Valeur Description
adStatusOK 1 L'opération qui a déclenché cet événement a réussi.
adStatusErrorsOccurred 2 L'opération qui a déclenché cet événement a échoué.
adStatusCantDeny 3 L'opération en suspens ne peut pas être annulée.
adStatusCancel 4 Annuler l'opération qui a déclenché l'événement.
adStatusUnwantedEvent 5 Interdire les notifications suivantes avant la fin de l'exécution de la méthode d'événement.