Compartir a través de

Eventos WillChangeRecordset y RecordsetChangeComplete (ADO)

  • Artículo

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

Sintaxis

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

Parámetros

adReason
Valor EventReasonEnum que especifica el motivo de este evento. Su valor puede ser adRsnRequery, adRsnResynch, adRsnClose y adRsnOpen.

adStatus
Valor de estado 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, adStatusErrorsOccurred si se produjo un error en la operación o adStatusCancel si se ha cancelado la operación asociada con el evento WillChangeRecordset aceptado anteriormente.

Antes de que se devuelva WillChangeRecordset, establezca este parámetro en adStatusCancel para solicitar la cancelación de la operación pendiente, o establezca este parámetro en adStatusUnwantedEvent para evitar las notificaciones posteriores.

Antes de que se devuelva WillChangeRecordset o RecordsetChangeComplete, establezca este parámetro en adStatusUnwantedEvent para evitar las notificaciones posteriores.

pError
Objeto Error. Describe el error que se produjo si el valor de adStatus es adStatusErrorsOccurred; de lo contrario, no está establecido.

pRecordset
Objeto Recordset. Objeto Recordset para el que se produjo este evento.

Comentarios

Puede producirse un evento WillChangeRecordset o RecordsetChangeComplete debido a los métodos Recordset Requery o Open.

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

Debe establecer el parámetro adStatus en adStatusUnwantedEvent para cada valor posible de adReason para detener completamente la notificación de eventos para cualquier evento que incluya un parámetro adReason.

Consulte también

Ejemplo de modelo de eventos de ADO (VC ++)
Conexión ADO y los eventos de conjunto de registros