WillMove- und MoveComplete-Ereignisse (ADO)
Gilt für: Access 2013, Office 2013
Das WillMove -Ereignis wird aufgerufen, bevor ein ausstehender Vorgang die aktuelle Position im Recordset-Objekt ändert. Das MoveComplete-Ereignis wird aufgerufen, nachdem die aktuelle Position im Recordset-Objekt geändert wurde.
Syntax
WillMoveadReason, adStatus, pRecordset
MoveCompleteadReason, pError, adStatus, pRecordset
Parameter
| Parameter | Beschreibung |
|---|---|
| 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 auftritt, wenn der Wert von adStatus auf adStatusErrorsOccurred festgelegt wird; andernfalls wird er nicht festgelegt. |
| adStatus |
EventStatusEnum. Wird WillMove aufgerufen, wird dieser Parameter auf adStatusOK festgelegt, wenn der das Ereignis verursachende Vorgang erfolgreich war. Der Parameter wird auf adStatusCantDeny festgelegt, wenn dieses Ereignis den Abbruch des ausstehenden Vorgangs nicht anfordern kann. Wird MoveComplete aufgerufen, wird dieser Parameter auf adStatusOK festgelegt, wenn der das Ereignis verursachende Vorgang erfolgreich war. Er wird auf adStatusErrorsOccurred festgelegt, wenn der Vorgang fehlgeschlagen ist. Before WillMove returns, set this parameter to adStatusCancel to request cancellation of the pending operation or set this parameter to adStatusUnwantedEvent to prevent subsequent notications. Legen Sie diesen Parameter vor der Rückgabe von MoveComplete auf AdStatusUnwantedEvent fest, um nachfolgende Benachrichtigungen zu verhindern. |
| pRecordset | Ein Recordset-Objekt. Das Recordset-Objekt, für das dieses Ereignis eingetreten ist. |
Hinweise
Ein WillMove - oder MoveComplete-Ereignis kann aufgrund der folgenden Recordset-Vorgänge auftreten:
Diese Ereignisse können aufgrund der folgenden Eigenschaften auftreten:
Diese Ereignisse treten außerdem ein, wenn mit einem untergeordneten Recordset -Objekt Recordset -Ereignisse verbunden sind und das übergeordnete Recordset -Objekt verschoben wird.
Sie müssen den adStatus -Parameter für jeden möglichen adReason -Wert auf adStatusUnwantedEvent festlegen, um Ereignisbenachrichtigungen für Ereignisse mit einem adReason -Parameter vollständig zu beenden.