Recomendação de curso:
Eventos WillExecute e ExecuteComplete do ADO
Definição e uso
- O evento é uma subrotina automaticamente chamada após a ocorrência de uma operação específica.
- O evento WillExecute é acionado antes da chamada de objcomm.Execute, objconn.Execute ou objrs.Open.
O evento ExecuteComplete é acionado após a chamada de objcomm.Execute, objconn.Execute, objrs.Open, objrs.Requery ou objrs.NextRecordset.
Sintaxe WillExecute src,cursortyp,locktyp,opções,status,objcomm,objrs,objconn
ExecuteComplete refectected,objerror,status,objcomm,objrs,objconn | Descrição |
---|---|
parâmetro | string que contém o nome do comando SQL ou do procedimento armazenado. |
cursortyp | define o tipo de cursor a ser usado.CursorTypeEnum um dos valores. |
locktyp | define o tipo de bloqueio a ser usado.LockTypeEnum um dos valores. |
opções | um ou mais CommandTypeEnum ou ExecuteOptionEnum Valor |
reaffected | Valor Long, número de registros afetados pelo comando. |
objerror |
Objeto Error contendo os erros ocorridos.
Notas: O valor de EventStatusEnum deve ser configurado como adStatusErrorsOccurred para criar o objeto Error. |
status | um EventStatusEnum valor. |
objcomm |
Para WillExecute: Se este evento for acionado por Command.Execute, o parâmetro objcomm referenciará o objeto Command e o parâmetro objrs será configurado como Nothing. Para ExecuteComplete: O objeto Command executado. |
objrs |
Para WillExecute: Se este evento for desencadeado por Recordset.Open, o parâmetro objrs referenciará o objeto Recordset, e o parâmetro pCommand será configurado como Nothing. Para ExecuteComplete: Objeto Recordset, é o resultado da execução do comando. |
objconn | Objeto Conexão associado à execução do comando. |
Valores do EventStatusEnum
Constante | Valor | Descrição |
---|---|---|
adStatusOK | 1 | A operação que desencadeou este evento foi bem-sucedida. |
adStatusErrorsOccurred | 2 | A operação que desencadeou este evento falhou. |
adStatusCantDeny | 3 | Não é possível cancelar a operação pendente. |
adStatusCancel | 4 | Cancelar a operação que causou o evento. |
adStatusUnwantedEvent | 5 | Proibir notificações subsequentes antes de completar a execução do método de evento. |