Eventos ADO WillConnect, ConnectComplete e Disconnect

Definição e uso

Os eventos são subrotinas automaticamente chamadas após a ocorrência de uma operação específica.

  • O evento WillConnect é acionado antes do início da conexão.
  • O evento ConnectComplete é acionado após o início da conexão.
  • O evento Disconnect é acionado após o final da conexão.

Sintaxe

WillConnect ConnectionString, userid, psword, options, status, objcon
Evento ConnectComplete objerror, status, objconn
Status de desconexão, objconn
Parâmetro Descrição
ConnectionString Uma string que contém as informações usadas para conexão.
userid Uma string que contém o nome de usuário usado para conexão.
psword Uma string que contém a senha usada para conexão.
options Valor Long, que indica a maneira como o provedor calcula o ConnectionString. A única opção é adAsyncOpen.
objerror

Objeto Error que contém os erros ocorridos.

Comentário:EventStatusEnum O valor deve ser configurado como adStatusErrorsOccurred para criar o objeto Error.

status

um EventStatusEnum Valor. O padrão é adStatusOK.

Quando o ConnectComplete for chamado, se o evento WillConnect solicitar o cancelamento da conexão pendente, este parâmetro será configurado como adStatusCancel.

objconn Aplicar este evento ao objeto Connection.

Valores do EventStatusEnum

Constante Valor Descrição
adStatusOK 1 A operação que causou este evento foi bem-sucedida.
adStatusErrorsOccurred 2 A operação que causou 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 concluir a execução do método de evento.