Evento WillExecute (ADO)
Aplica-se ao: Access 2013, Office 2013
O evento WillExecute é chamado um pouco antes da execução de um comando pendente, em uma conexão.
Sintaxe
WillExecuteSource, CursorType, LockType, Options, adStatus, pCommand, pRecordset, pConnection
Parâmetros
| Parâmetro | Descrição |
|---|---|
| Source | Uma sequência de caracteres que contém um comando SQL ou um nome de procedimento armazenado. |
| CursorType | Um CursorTypeEnum que contém o tipo de cursor para o Recordset que será aberto. Com esse parâmetro, você pode alterar o cursor para qualquer tipo, durante a operação Open do Recordset. O CursorType será ignorado para qualquer outra operação. |
| LockType | Um LockTypeEnum que contém o tipo de bloqueio para o Recordset que será aberto. Com este parâmetro, pode alterar o bloqueio para qualquer tipo durante uma operação Abrir Conjunto de Registos. O LockType será ignorado para qualquer outra operação. |
| Options | Um valor Long que indica as opções que podem ser usadas para executar o comando ou abrir o Recordset. |
| adStatus | EventStatusEnum. Antes que esse evento retorne, defina esse parâmetro como adStatusUnwantedEvent, para evitar notificações subsequentes, ou como adStatusCancel para solicitar o cancelamento da operação que gerou esse evento. |
| pCommand | O objeto Command ao qual essa notificação de evento se aplica. |
| pRecordset | O objeto Recordset ao qual essa notificação de evento se aplica. |
| pConnection | O objeto Connection ao qual essa notificação de evento se aplica. |
Comentários
Pode ocorrer um evento WillExecute devido a uma Ligação.Execute, Comando.Execute ou Conjunto de registos.Método open O parâmetro pConnection deve conter sempre uma referência válida a um objeto De ligação . Se o evento ocorrer devido a Connection.Execute, os parâmetros pRecordset e pCommand serão definidos como Nothing. Se o evento ocorrer devido a Recordset.Open, o parâmetro pRecordset fará referência ao objeto Recordset e o parâmetro pCommand será definido como Nothing. Se o evento ocorrer devido a Command.Execute, o parâmetro pCommand fará referência ao objeto Command e o parâmetro pRecordset será definido como Nothing.
WillExecute permite examinar e modificar os parâmetros de execução pendentes. Esse evento pode retornar uma solicitação para que o comando pendente seja cancelado.