Compartir a través de

Eventos WillMove y MoveComplete (ADO)

  • Artículo

Se llama al evento WillMove antes de que una operación pendiente cambie la posición actual en el objeto Recordset. Se llama al evento MoveComplete después de que cambie la posición actual del objeto Recordset.

Sintaxis

  
WillMove adReason, adStatus, pRecordset  
MoveComplete adReason, pError, adStatus, pRecordset

Parámetros

adReason
Valor EventReasonEnum que especifica el motivo de este evento. Su valor puede ser adRsnMoveFirst, adRsnMoveLast, adRsnMoveNext, adRsnMovePrevious, adRsnMove, o adRsnRequery.

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

adStatus
Valor del estado EventStatusEnum.

Cuando se llama a WillMove, 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 MoveComplete, este parámetro se establece en adStatusOK si la operación que provocó el evento se realizó correctamente o en adStatusErrorsOccurred si se produjo un error en la operación.

Antes de que WillMove devuelva, 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 MoveComplete, establezca este parámetro en adStatusUnwantedEvent para evitar las notificaciones posteriores.

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

Comentarios

Puede producirse un evento WillMove o MoveComplete debido a las siguientes operaciones del Recordset: Open, Move, MoveFirst, MoveLast, MoveNext, MovePrevious, AddNew, and Requery. Estos eventos pueden producirse debido a las siguientes propiedades: Filter, Index, Bookmark, AbsolutePage y AbsolutePosition. Estos eventos también se producen si un Recordset secundario tiene eventos Recordset conectados y se mueve el objeto Recordset primario.

Debe establecer el parámetro adStatus en adStatusUnwantedEvent para cada valor posible de adReason con el fin de 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
Objeto de conjunto de registros (ADO)