ADO WillMove- und MoveComplete- Ereignisse
❮ Vollständige Recordset-Objektreferenz
Das WillMove-Event
Das WillMove-Ereignis wird ausgelöst, bevor eine Operation die aktuelle Position im Recordset ändert.
Hinweis: Bevor dieses Ereignis zurückkehrt, setzen Sie den Statusparameter auf adStatusCancel, um den Vorgang abzubrechen, der dieses Ereignis verursacht hat, oder setzen Sie ihn auf adStatusUnwantedEvent, um nachfolgende Benachrichtigungen zu verhindern.
Das MoveComplete-Ereignis
Das MoveComplete-Ereignis wird ausgelöst, nachdem sich die aktuelle Position im Recordset geändert hat.
Hinweis: Bevor dieses Ereignis zurückkehrt, setzen Sie den Statusparameter auf adStatusUnwantedEvent, um nachfolgende Benachrichtigungen zu verhindern.
Hinweis: Das Ereignis WillMove oder MoveComplete kann auftreten, wenn eine der folgenden Recordset-Methoden aufgerufen wird: Open, Move, MoveFirst, MoveLast, MoveNext, MovePrevious, AddNew und Requery. Diese Ereignisse können auch aufgrund der folgenden Eigenschaften auftreten: Filter, Index, Bookmark, AbsolutePage und AbsolutePosition.
Syntax
WillMove reason,status,objRs
MoveComplete reason,objErr,status,objRs
Parameter | Description |
---|---|
reason | An EventReasonEnum value that specifies the reason for this event |
status | An EventStatusEnum value that indicates the status of the execution of the event |
objErr | The name of an Error object that describes the error if status is set to adStatusErrorsOccurred, otherwise it is not set |
objRs | The name of the Recordset object that triggered this event |
EventReasonEnum-Werte
Constant | Value | Description |
---|---|---|
adRsnRequery | 7 | An operation requeried the Recordset |
adRsnMove | 10 | An operation moved the record pointer within the Recordset |
adRsnMoveFirst | 12 | An operation moved the record pointer to the first record in the Recordset |
adRsnMoveNext | 13 | An operation moved the record pointer to the next record in the Recordset |
adRsnMovePrevious | 14 | An operation moved the record pointer to the previous record in the Recordset |
adRsnMoveLast | 15 | An operation moved the record pointer to the last record in the Recordset |
EventStatusEnum-Werte
Constant | Value | Description |
---|---|---|
adStatusOK | 1 | The operation that caused the event was successful |
adStatusErrorsOccurred | 2 | The operation that caused the event failed |
adStatusCantDeny | 3 | The operation that caused the event cannot be cancelled |
adStatusCancel | 4 | The operation that caused the event is cancelled |
adStatusUnwantedEvent | 5 | Prevents subsequent notifications before the event method has finished executing |
❮ Vollständige Recordset-Objektreferenz