Compartilhar via


Resumo do manipulador de eventos do ADO

Aplica-se ao: Access 2013, Office 2013

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

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

  • Eventos Recordset: os eventos são emitidos em operações de busca assíncrona e 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 de servidor, fecha um Recordset ou faz uma alteração no Recordset.

As seguintes tabelas resumem os eventos e suas descrições.

ConnectionEvent

Descrição

BeginTransComplete, CommitTransComplete, RollbackTransComplete

Gerenciamento de transação — Notificação sobre o início, a confirmação ou a reversão da transação atual na conexão.

WillConnect, ConnectComplete, Disconnect

Gerenciamento de conexão — Notificação informando que a conexão atual será iniciada, foi iniciada ou foi finalizada.

WillExecute, ExecuteComplete

Gerenciamento de execução de comandos — Notificação informando que a execução do comando atual na conexão será iniciada ou foi finalizada.

Infomessage

Informativa — Notificação sobre a existência de 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 da conclusão da operação de recuperação. Esses eventos estarão disponíveis somente se Recordset tiver sido aberto com a utilização de um curso do cliente.

WillChangeField, FieldChangeComplete

Gerenciamento de alterações do campo — Notificação informando que o valor do campo atual será alterado ou foi alterado.

WillMove, MoveComplete, EndOfRecordset

Gerenciamento de navegação — Notificação informando que a posição atual da linha em um Recordset será alterada, foi alterada ou atingiu o final do Recordset.

WillChangeRecord, RecordChangeComplete

Gerenciamento de alteração de linha — Notificação informando que algo na linha atual do Recordset será alterado ou foi alterado.

WillChangeRecordset, RecordsetChangeComplete

Gerenciamento de alteração de Recordset — Notificação informando que algo no Recordset será alterado ou foi alterado.