Partager via


Événement WillExecute (ADO)

S’applique à : Access 2013, Office 2013

L'événement WillExecute est appelé juste avant l'exécution d'une commande en attente sur une connexion.

Syntaxe

WillExecuteSource, CursorType, LockType, Options, adStatus, pCommand, pRecordset, pConnection

Paramètres

Paramètre Description
Source Valeur de type String reprenant le nom d'une commande SQL ou d'une procédure stockée.
CursorType Valeur CursorTypeEnum contenant le type de curseur pour l'objet Recordset qui sera ouvert. Ce paramètre permet de modifier le type de curseur pendant l'exécution de la méthode Open) sur un objet Recordset. La valeur du paramètre CursorType est ignorée pour tout autre type d’opération.
LockType Valeur LockTypeEnum contenant le type de verrouillage de l'objet Recordset qui sera ouvert. Avec ce paramètre, vous pouvez remplacer le verrou par n’importe quel type pendant une opération d’ouverture d’objet Recordset. La valeur de LockType est ignorée pour tout autre type d’opération.
Options Valeur de type Long indiquant les options qui peuvent être utilisées pour exécuter la commande ou ouvrir l'objet Recordset.
adStatus EventStatusEnum. Avant que cet événement soit retourné, définissez ce paramètre à adStatusUnwantedEvent pour éviter toute notification ultérieure ou à adStatusCancel pour demander l'annulation de l'opération à l'origine de l'événement.
pCommand Objet Command auquel cette notification d'événement s'applique.
pRecordset Objet Recordset auquel cette notification d'événement s'applique.
pConnection Objet Connection auquel cette notification d'événement s'applique.

Remarques

Un événement WillExecute peut se produire en raison d’une connexion.Execute, Command.Execute, ou Recordset.Méthode Open Le paramètre pConnection doit toujours contenir une référence valide à un objet Connection . Si l’événement est dû à Connection.Execute, les paramètres pRecordset et pCommand sont définis sur Nothing. Si l’événement est dû à Recordset.Open, le paramètre pRecordset référence l’objet Recordset et le paramètre pCommand est défini sur Nothing. Si l’événement est dû à Command.Execute, le paramètre pCommand fait référence à l’objet Command et le paramètre pRecordset est défini sur Nothing.

WillExecute permet de passer en revue et de modifier les paramètres d'exécution en attente. Il se peut que cet événement retourne une demande d'annulation de la commande en attente.