Freigeben über

WillMove- und MoveComplete-Ereignisse (ADO)

  • Artikel

Das WillMove-Ereignis wird aufgerufen, bevor ein ausstehender Vorgang die aktuelle Position im Recordset-ändert. Das MoveComplete--Ereignis wird aufgerufen, nachdem sich die aktuelle Position im Recordset ändert.

Syntax

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

Parameter

adReason
Ein EventReasonEnum Wert, der den Grund für dieses Ereignis angibt. Der Wert kann adRsnMoveFirst, adRsnMoveLast, adRsnMoveNext, adRsnMovePrevious, adRsnMoveoder adRsnRequery.

pError-
Ein Error-Objekt. Es beschreibt den Fehler, der aufgetreten ist, wenn der Wert von adStatus-adStatusErrorsOccurredist; andernfalls wird der Parameter nicht festgelegt.

adStatus-
Ein EventStatusEnum Statuswert.

Wenn WillMove aufgerufen wird, wird dieser Parameter auf adStatusOK- festgelegt, wenn der Vorgang, der das Ereignis verursacht hat, erfolgreich war. Es ist auf adStatusCantDeny festgelegt, wenn dieses Ereignis den Abbruch des ausstehenden Vorgangs nicht anfordern kann.

Wenn MoveComplete- aufgerufen wird, wird dieser Parameter auf adStatusOK- festgelegt, wenn der Vorgang, der das Ereignis verursacht hat, erfolgreich war, oder adStatusErrorsOccurred, wenn der Vorgang fehlgeschlagen ist.

Bevor WillMove zurückgibt, legen Sie diesen Parameter auf adStatusCancel fest, um den Abbruch des ausstehenden Vorgangs anzufordern, oder legen Sie diesen Parameter auf adStatusUnwantedEvent- fest, um nachfolgende Benachrichtigungen zu verhindern.

Bevor MoveComplete- zurückgegeben wird, legen Sie diesen Parameter auf adStatusUnwantedEvent- fest, um nachfolgende Benachrichtigungen zu verhindern.

pRecordset-
Ein Recordset-Objekt. Das Recordset, für das dieses Ereignis aufgetreten ist.

Bemerkungen

Ein WillMove- oder MoveComplete--Ereignis kann aufgrund der folgenden Recordset--Vorgänge auftreten: Öffnen, Verschieben, MoveFirst, MoveLast, MoveNext, MovePrevious, AddNewund Requery. Diese Ereignisse können aufgrund der folgenden Eigenschaften auftreten: Filter, Index, Bookmark, AbsolutePage-und AbsolutePosition. Diese Ereignisse treten auch auf, wenn ein untergeordnetes RecordsetRecordset- Verbundene Ereignisse aufweist und das übergeordnete Recordset- verschoben wird.

Sie müssen den adStatus-parameter auf adStatusUnwantedEvent für jeden möglichen adReason Wert festlegen, um die Ereignisbenachrichtigung für jedes Ereignis, das einen adReason Parameter enthält, vollständig zu beenden.

Siehe auch

ADO-Ereignismodell (Beispiel) (VC++)
ADO-Ereignishandlerzusammenfassung
Recordset-Objekt (ADO)