Eventi WillMove e MoveComplete (ADO)

L'evento WillMove viene chiamato prima che un'operazione in sospeso cambi la posizione corrente nel recordset. L'evento MoveComplete viene chiamato dopo la modifica della posizione corrente nel recordset.

Sintassi

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

Parametri

adReason
Valore EventReasonEnum che specifica il motivo dell'evento. Il valore può essere adRsnMoveFirst, adRsnMoveLast, adRsnMoveNext, adRsnMovePrevious, adRsnMove o adRsnRequery.

pError
Oggetto Error. Descrive l'errore che si è verificato se il valore di adStatus è adStatusErrorsOccurred; in caso contrario, il parametro non è impostato.

adStatus
Valore di stato EventStatusEnum.

Quando viene chiamato WillMove, questo parametro viene impostato su adStatusOK se l'operazione che ha causato l'evento ha avuto esito positivo. È impostato su adStatusCantDeny se questo evento non può richiedere l'annullamento dell'operazione in sospeso.

Quando viene chiamato MoveComplete, questo parametro viene impostato su adStatusOK se l'operazione che ha causato l'evento ha avuto esito positivo oppure su adStatusErrorsOccurred se l'operazione ha avuto esito negativo.

Prima del ritorno di WillMove, impostare questo parametro su adStatusCancel per richiedere l'annullamento dell'operazione in sospeso oppure impostare questo parametro su adStatusUnwantedEvent per impedire notifiche successive.

Prima del completamento di MoveComplete, impostare questo parametro su adStatusUnwantedEvent per impedire notifiche successive.

pRecordset
Oggetto Recordset. Oggetto Recordset per cui si è verificato l'evento.

Commenti

Un evento WillMove o MoveComplete può verificarsi a causa delle operazioni Recordset seguenti: Open, Move, MoveFirst, MoveLast, MoveNext, MovePrevious, AddNewe Requery. Questi eventi possono verificarsi a causa delle proprietà seguenti: Filter, Index, Bookmark, AbsolutePagee AbsolutePosition. Questi eventi si verificano anche se un recordset figlio ha eventi Recordset connessi e il recordset padre viene spostato.

È necessario impostare il parametro adStatus su adStatusUnwantedEvent per ogni possibile valore adReason per arrestare completamente la notifica degli eventi per qualsiasi evento che include un parametro adReason.

Vedere anche

Esempio di modello di eventi ADO (VC++)
Riepilogo del gestore eventi ADO
Oggetto Recordset (ADO)