WillExecute, événement (ADO)

L’événement WillExecute est appelé juste avant qu’une commande en attente s’exécute sur une connexion.

Syntaxe

  
WillExecute Source, CursorType, LockType, Options, adStatus, pCommand, pRecordset, pConnection  

Paramètres

Source
Paramètre String contenant une commande SQL ou un nom de procédure stockée.

CursorType
Paramètre CurseurTypeEnum contenant le type de curseur pour l’objet Recordset qui sera ouvert. Avec ce paramètre, vous pouvez modifier le curseur en n’importe quel type pendant une opération RecordsetOpen, méthode (objet Recordset ADO). La propriété CursorType sera ignorée pour toute autre opération.

LockType
Paramètre LockTypeEnum contenant le type de verrou pour l’objet Recordset qui sera ouvert. Avec ce paramètre, vous pouvez modifier le verrou en n’importe quel type pendant une opération RecordsetOpen . La propriété LockType sera ignorée pour toute autre opération.

Options
Valeur Long indiquant les options qui peuvent être utilisées pour exécuter la commande ou ouvrir l’objet Recordset.

adStatus
Valeur d’état EventStatusEnum qui peut être adStatusCantDeny ou adStatusOK lors de l’appel de cet événement. S’ils s’agit de adStatusCantDeny, cet événement ne peut pas demander l’annulation de l’opération en attente.

pCommand
Objet Command, objet (ADO) pour lequel cette notification d’événement s’applique.

pRecordset
Objet Recordset, objet (ADO) pour lequel cette notification d’événement s’applique.

pConnection
Objet Connection, objet (ADO) pour lequel cette notification d’événement s’applique.

Notes

Un événement WillExecute peut se produire en raison d’un objet Connection. Méthode Execute, méthode (objet Connection ADO), Execute, méthode (objet Command ADO) ou Open, méthode (objet Recordset ADO). Le paramètre pConnection devrait 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 référence l’objet Command, et le paramètre pRecordset est défini sur Nothing.

Un événement WillExecute vous permet d’examiner et de modifier les paramètres d’exécution en attente. Cet événement peut retourner une demande d’annulation de la commande en attente.

Notes

Si la source d’origine d’un objet Command est un flux spécifié par la propriété CommandStream, propriété (ADO), l’affectation d’une nouvelle chaîne au paramètre WillExecuteSource modifie la source de l’objet Command. La propriété CommandStream sera effacée, et la propriété CommandText, propriété (ADO) sera mise à jour avec la nouvelle source. Le flux d’origine spécifié par la propriété CommandStream sera libéré et est inaccessible.

Si le dialecte de la nouvelle chaîne source diffère du paramétrage d’origine de la propriété Dialect Property (qui correspond à la propriété CommandStream), le dialecte correct doit être spécifié en définissant la propriété Dialect de l’objet commande référencé par l’objet pCommand.

Voir aussi

Exemple de modèle d’événements ADO (VC ++)
Présentation rapide du gestionnaire d’événements ADO
Connection, objet (ADO)