Compartilhar via

Evento WillExecute (ADO)

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

Fonte
Uma cadeia de caracteres que contém um comando SQL ou um nome de procedimento armazenado.

TipoDeCursor
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 uma operação do Recordset Open Method (ADO Recordset). CursorType será ignorado para qualquer outra operação.

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

Opções
Um valor long que indica opções que podem ser usadas para executar o comando ou abrir o Conjunto de Registros.

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 ADO (objeto Command) para o qual essa notificação de evento se aplica.

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

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

Observações

Um evento WillExecute pode ocorrer devido a uma Conexão. Método Execute (Conexão ADO),Método Execute (Comando do ADO) ou método Open Method (ADO Recordset) O parâmetro pConnection sempre deve 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 que você examine e modifique 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 origem original de um Comando for um fluxo especificado pela propriedade ADO (Propriedade CommandStream), atribuir uma nova cadeia de caracteres ao parâmetro De origemWillExecute alterará a origem do Comando. A propriedade CommandStream será desmarcada e a propriedade CommandText Property (ADO) será atualizada com a nova origem. 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 Propriedade Dialeto (que correspondeu ao CommandStream), o dialeto correto deverá ser especificado definindo a propriedade Dialeto do objeto de comando referenciado por pCommand.

Consulte Também

exemplo de modelo de eventos do ADO (VC++)
resumo do manipulador de eventos do ADO
Objeto de Conexão (ADO)

  • Last updated on