WillMove- und MoveComplete-Ereignis (ADO)

  • Artikel

Das WillMove-Ereignis wird aufgerufen, bevor ein ausstehender Vorgang die aktuelle Position im Recordset ändert. Das MoveComplete-Ereignis wird nach der aktuellen Position in den Recordset-Änderungen aufgerufen.

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, adRsnMove oder adRsnRequery sein.

pError
Ein Error-Objekt. Es beschreibt den Fehler, der aufgetreten ist, wenn der Wert von adStatusadStatusErrorsOccurred ist. Andernfalls ist 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 wird auf adStatusCantDeny festgelegt, wenn dieses Ereignis keinen Abbruch des ausstehenden Vorgangs anfordern kann.

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

Legen Sie diesen Parameter vor dem Zurückgeben von WillMove 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 weitere 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: Open, Move, MoveFirst, MoveLast, MoveNext, MovePrevious, AddNew und Requery. Diese Ereignisse können aufgrund der folgenden Eigenschaften auftreten: Filter, Index, Bookmark, AbsolutePage und AbsolutePosition. Diese Ereignisse treten auch auf, wenn ein untergeordnetes Recordset mit Recordset-Ereignissen verbunden ist 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.

Weitere Informationen

ADO-Ereignismodell – Beispiel (VC++)
ADO-Ereignishandler – Übersicht
Recordset-Objekt (ADO)