Eventos WillChangeRecordset y RecordsetChangeComplete (ADO)

Se aplica a: Access 2013, Office 2013

Al evento WillChangeRecordset se le llama antes de que una operación pendiente cambie el Recordset. Al evento RecordsetChangeComplete se le llama después de que el objeto Recordset haya cambiado.

Sintaxis

WillChangeRecordsetadReason, adStatus, pRecordset

RecordsetChangeCompleteadReason, pError, adStatus, pRecordset

Parámetros

Parámetro	Descripción
adReason	An EventReasonEnum value that specifies the reason for this event. Su valor puede ser adRsnRequery, adRsnResynch, adRsnClose o adRsnOpen.
adStatus	EventStatusEnum. Cuando se llama a WillChangeRecordset, este parámetro se establece en adStatusOK si la operación que provocó el evento se realizó correctamente. Se establece en adStatusCantDeny si este evento no puede solicitar la cancelación de la operación pendiente. Cuando se llama a RecordsetChangeComplete, este parámetro se establece en adStatusOK si la operación que provocó el evento se realizó correctamente, en adStatusErrorsOccurred si se produjo un error en la operación o en adStatusCancel si se ha cancelado la operación asociada al evento WillChangeRecordset anteriormente aceptado. Antes de que WillChangeRecordset vuelva, establezca este parámetro en adStatusCancel para solicitar la cancelación de la operación pendiente, o en adStatusUnwantedEvent para impedir notificaciones posteriores. Antes de que WillChangeRecordset o RecordsetChangeComplete vuelva, establezca este parámetro en adStatusUnwantedEvent para impedir notificaciones posteriores.
pError	Objeto Error. Describe el posible error si el valor de adStatus es adStatusErrorsOccurred; de lo contrario, no se establece un valor para él.
pRecordset	Objeto Recordset. El objeto Recordset para el que se produjo este evento.

Comentarios

Los eventos WillChangeRecordset o RecordsetChangeComplete pueden ocurrir debido a los métodos de RecordsetRequery u Open.

Si el proveedor no admite marcadores, se produce una notificación de evento RecordsetChange cada vez de que se recuperan filas nuevas del proveedor. La frecuencia de este evento depende de la propiedad RecordsetCacheSize.

Deberá establecer el parámetro adStatus como adStatusUnwantedEvent para cada valor posible de adReason con el fin de detener completamente la notificación de eventos para cualquier suceso que incluya un parámetro adReason.