Eventos de conexão e conjunto de registros do ADO

Dois objetos ADO podem gerar eventos: o objeto Connection e o objeto Recordset. A família ConnectionEvent pertence às operações do objeto Connection, e a família RecordsetEvent pertence às operações do objeto Recordset.

• Eventos de conexão: os eventos são emitidos quando uma transação em uma conexão é iniciada, é confirmada ou é revertida; quando um Command é executado; quando um aviso ocorre durante uma operação Connection Event ou quando uma Connection é iniciada ou encerrada.

• Eventos do Recordset: os eventos são emitidos em operações de busca assíncronas, bem como quando você navega pelas linhas de um objeto Recordset, altera um campo em uma linha de um Recordset, altera uma linha em um Recordset, abre um Recordset com um cursor do lado do servidor, fecha um Recordset ou faz qualquer alteração no Recordset.

As tabelas a seguir resumem os eventos e as respectivas descrições.

ConnectionEvent	Descrição
BeginTransComplete, CommitTransComplete, RollbackTransComplete	Gerenciamento de transações – Notificação de que a transação atual na conexão foi iniciada, confirmada ou revertida.
WillConnect, ConnectComplete, Disconnect	Gerenciamento de conexões – Notificação de que a conexão atual será iniciada, foi iniciada ou foi encerrada.
WillExecute, ExecuteComplete	Gerenciamento de execução de comando – Notificação de que a execução do comando atual na conexão será iniciada ou foi encerrada.
InfoMessage	Informativo – Notificação de que há informações adicionais sobre a operação atual.

RecordsetEvent	Descrição
FetchProgress, FetchComplete	Status de recuperação – Notificação do progresso de uma operação de recuperação de dados ou de que a operação de recuperação foi concluída. Esses eventos só estarão disponíveis se o Recordset tiver sido aberto com um cursor do lado do cliente.
WillChangeField, FieldChangeComplete	Gerenciamento de alterações de campo – Notificação de que o valor do campo atual será alterado ou foi alterado.
WillMove, MoveComplete, EndOfRecordset	Gerenciamento de navegação – Notificação de que a posição da linha atual em um Recordset será alterada, foi alterada ou atingiu o final do Recordset.
WillChangeRecord, RecordChangeComplete	Gerenciamento de alterações de linha – Notificação de que algo na linha atual do Recordset será alterado ou foi alterado.
WillChangeRecordset, RecordsetChangeComplete	Gerenciamento de alterações do conjunto de registros – Notificação de que algo no Recordset atual será alterado ou foi alterado.

Consulte Também

Instanciação de evento ADO por linguagemEvento ADOParâmetros de eventosComo os manipuladores de eventos trabalham juntosTipos de eventos