Compartilhar via

Evento WillExecute (ADO)

  • Artigo

O evento WillExecute é chamado pouco antes de um comando pendente ser executado em uma conexão.

Sintaxe

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

Parâmetros

Origem
Uma String que contém um comando SQL ou um nome de procedimento armazenado.

CursorType
Um CursorTypeEnum que contém o tipo de cursor do Recordset que será aberto. Com esse parâmetro, você pode alterar o cursor para qualquer tipo durante uma operação do RecordsetOpen Method (ADO Recordset). CursorType será ignorado em qualquer outra operação.

LockType
Um LockTypeEnum que contém o tipo de bloqueio do Recordset que será aberto. Com esse parâmetro, você pode alterar o bloqueio para qualquer tipo durante uma operação RecordsetOpen. LockType será ignorado em qualquer outra operação.

Opções
Um valor Long que indica opções que podem ser usadas para executar o comando ou abrir o Recordset.

adStatus
Um valor de status EventStatusEnum que pode ser adStatusCantDeny ou adStatusOK quando esse evento é chamado. Se for adStatusCantDeny, esse evento poderá não solicitar o cancelamento da operação pendente.

pCommand
O objeto Command Object (ADO) para o qual essa notificação de evento se aplica.

pRecordset
O objeto Recordset Object (ADO) para o qual essa notificação de evento se aplica.

pConnection
O objeto Connection Object (ADO) para o qual essa notificação de evento se aplica.

Comentários

Um evento WillExecute pode ocorrer devido a uma conexão. Execute Method (ADO Connection), Execute Method (ADO Command) ou Open Method (ADO Recordset) O parâmetro pConnection deve sempre conter uma referência válida a um objeto Connection. Se o evento for devido a Connection.Execute, os parâmetros pRecordset e pCommand serão definidos como Nothing. Se o evento for 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 for 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.

Observação

Se a fonte original de um Command for um fluxo especificado pela propriedade CommandStream Property (ADO), a atribuição de uma nova cadeia de caracteres ao parâmetro WillExecuteSource altera a fonte do Command. A propriedade CommandStream será desmarcada e a propriedade CommandText Property (ADO) será atualizada com a nova fonte. O fluxo original especificado pelo CommandStream será liberado e não poderá ser acessado.

Se o dialeto da nova cadeia de caracteres de origem for diferente da configuração original da propriedade Dialect Property (que correspondia ao CommandStream), o dialeto correto precisará ser especificado com a definição da propriedade Dialect do objeto de comando referenciado por pCommand.

Confira também

Exemplo do modelo de eventos ADO (VC++)
Resumo do manipulador de eventos ADO
Objeto Connection (ADO)