Compartilhar via

Eventos WillChangeRecordset e RecordsetChangeComplete (ADO)

  • Artigo

O evento WillChangeRecordset é chamado antes que uma operação pendente altere o Recordset. O evento RecordsetChangeComplete é chamado após a alteração do do conjunto de registros.

Sintaxe

  
WillChangeRecordset adReason, adStatus, pRecordset  
RecordsetChangeComplete adReason, pError, adStatus, pRecordset

Parâmetros

adReason
Um valor EventReasonEnum que especifica o motivo desse evento. Seu valor pode ser adRsnRequery, adRsnResynch, adRsnClose, adRsnOpen.

adStatus
Um valor de status EventStatusEnum.

Quando willChangeRecordset é chamado, esse parâmetro é definido como adStatusOK se a operação que causou o evento foi bem-sucedida. Ele será definido como adStatusCantDeny se esse evento não puder solicitar o cancelamento da operação pendente.

Quando RecordsetChangeComplete é chamado, esse parâmetro será definido como adStatusOK se a operação que causou o evento tiver sido bem-sucedida, adStatusErrorsOccurred se a operação falhou ou adStatusCancel se a operação associada ao evento WillChangeRecordset foi cancelada.

Antes de WillChangeRecordset retornar, defina esse parâmetro como adStatusCancel para solicitar o cancelamento da operação pendente ou definir esse parâmetro como adStatusUnwantedEvent para evitar notificações subsequentes.

Antes de WillChangeRecordset ou RecordsetChangeComplete retornar, defina esse parâmetro como adStatusUnwantedEvent para evitar notificações subsequentes.

pError
Um objeto Error. Ele descreve o erro que ocorreu se o valor de adStatus for adStatusErrorsOccurred; caso contrário, não está definido.

pRecordset
Um objeto Recordset. O conjunto de registros para o qual esse evento ocorreu.

Observações

Um evento WillChangeRecordset ou RecordsetChangeComplete pode ocorrer devido aos métodos RecordsetRequery ou Open.

Se o provedor não der suporte a indicadores, uma notificação de evento RecordsetChange ocorrerá sempre que novas linhas forem recuperadas do provedor. A frequência desse evento depende da propriedade RecordsetCacheSize.

Você deve definir o parâmetro adStatus para adStatusUnwantedEvent para cada possível adReason valor para interromper completamente a notificação de evento para qualquer evento que inclua um parâmetro adReason.

Consulte Também

exemplo de modelo de eventos do ADO (VC++)
resumo do manipulador de eventos do ADO