Eventi WillMove e MoveComplete (ADO)

L'evento di WillMove viene chiamato prima che un'operazione in sospeso cambi la posizione corrente nell'oggetto Recordset . L'evento MoveComplete viene chiamato dopo che la posizione corrente nell'oggetto Recordset cambia.

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, adRsnMoveMoveo 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 è stata completata correttamente. È 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 è stata completata correttamente oppure adStatusErrorsOccurred se l'operazione non è riuscita.

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

Prima di restituisce MoveComplete, impostare questo parametro su adStatusUnwantedEvent per impedire le notifiche successive.

pRecordset
Oggetto recordset . recordset per cui si è verificato questo evento.

Osservazioni

È possibile che si verifichi un evento WillMove WillMove o MoveComplete 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 l' 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 includa un parametro adReason.

Vedere anche

esempio di modello di eventi ADO (VC++)
riepilogo del gestore eventi ADO
oggetto Recordset (ADO)