Condividi tramite

Eventi WillMove e MoveComplete (ADO)

  • Articolo

L'evento WillMove viene chiamato prima che un'operazione in sospeso modifichi la posizione corrente nell'oggetto Recordset. L'evento MoveComplete viene chiamato dopo la modifica della posizione corrente nell'oggetto Recordset.

Sintassi

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

Parametri

adReason
Valore EventReasonEnum che specifica il motivo di questo 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 viene impostato.

adStatus
Valore di stato EventStatusEnum.

Quando viene chiamato WillMove, questo parametro viene impostato su adStatusOK se l'operazione che ha causato l'evento è riuscita. È 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 è riuscita o su 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 restituire MoveComplete, impostare questo parametro su adStatusUnwantedEvent per impedire le notifiche successive.

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

Osservazioni

Un evento WillMove o MoveComplete può verificarsi a causa delle operazioni di Recordset seguenti: Open, Move, MoveFirst, MoveLast, MoveNext, MovePrevious, AddNew e Requery. Questi eventi possono verificarsi a causa delle proprietà seguenti: Filter, Index, Bookmark, AbsolutePage e AbsolutePosition. Questi eventi si verificano anche se per un oggetto Recordset figlio esistono eventi di Recordset connessi e l'oggetto 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 del modello di eventi ADO (VC++)
Riepilogo dei gestori eventi ADO
Oggetto Recordset (ADO)