Événements WillExecute et ExecuteComplete ADO
Définition et utilisation
L'événement est une sous-routine appelée automatiquement après qu'une opération spécifique a été effectuée.
- L'événement WillExecute est déclenché avant l'appel à objcomm.Execute, objconn.Execute ou objrs.Open.
- L'événement ExecuteComplete est déclenché après l'appel à objcomm.Execute, objconn.Execute, objrs.Open, objrs.Requery ou objrs.NextRecordset.
Syntaxe
WillExecute src,cursortyp,locktyp,options,status,objcomm,objrs,objconn ExecuteComplete reaffected,objerror,status,objcomm,objrs,objconn
| paramètres | Description |
|---|---|
| src | Chaîne contenant la commande SQL ou le nom de la procédure stockée. |
| cursortyp | Détermine le type de curseur à utiliser.CursorTypeEnum une des valeurs. |
| locktyp | Détermine le type de verrouillage à utiliser.LockTypeEnum une des valeurs. |
| options | un ou plusieurs CommandTypeEnum ou ExecuteOptionEnum Valeur |
| reaffected | Valeur Long, nombre d'enregistrements affectés par la commande. |
| objerror |
Objet Error contenant les erreurs survenues.
Remarque : la valeur EventStatusEnum doit être configurée en adStatusErrorsOccurred pour créer cet objet Error. |
| status | un EventStatusEnum valeur. |
| objcomm |
Pour WillExecute : si cet événement est déclenché par Command.Execute, le paramètre objcomm fait référence à l'objet Command, et le paramètre objrs est configuré comme Nothing. Pour ExecuteComplete : l'objet Command exécuté. |
| objrs |
Pour WillExecute : si cet événement est déclenché par Recordset.Open, le paramètre objrs fait référence à l'objet Recordset, et le paramètre pCommand est réglé sur Nothing. Pour ExecuteComplete : l'objet Recordset, est le résultat de l'exécution de la commande. |
| objconn | L'objet Connection associé à l'exécution de la commande. |
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. |
