Compartir a través de

Eventos WillMove y MoveComplete (ADO)

  • Artículo

Se aplica a: Access 2013, Office 2013

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

Sintaxis

WillMoveadReason, adStatus, pRecordset

MoveCompleteadReason, pError, adStatus, pRecordset

Parámetros

Parámetro Descripción
adReason Valor de 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, no se establece ningún valor.
adStatus 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 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 MoveComplete vuelva, establezca este parámetro en adStatusUnwantedEvent para impedir notificaciones posteriores.
pRecordset Objeto Recordset. El objeto Recordset para el que se produjo este evento.

Comentarios

Puede producirse un evento WillMove o MoveComplete debido a las siguientes operaciones recordset :

Estos eventos pueden producirse debido a las siguientes propiedades:

Estos eventos también se producen si un objeto Recordset secundario tiene eventos de Recordset conectados y se mueve su Recordset principal.

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.