WillChangeRecordset- und RecordsetChangeComplete-Ereignisse (ADO)
Gilt für: Access 2013, Office 2013
Das WillChangeRecordset -Ereignis wird aufgerufen, bevor ein ausstehender Vorgang das Recordset-Objekt ändert. Das RecordsetChangeComplete-Ereignis wird aufgerufen, nachdem das Recordset-Objekt geändert wurde.
Syntax
WillChangeRecordsetadReason, adStatus, pRecordset
RecordsetChangeCompleteadReason, pError, adStatus, pRecordset
Parameter
| Parameter | Beschreibung |
|---|---|
| adReason | Ein EventReasonEnum-Wert, der den Grund für dieses Ereignis angibt. Der Wert kann adRsnRequery, adRsnResynch, adRsnClose oder adRsnOpen sein. |
| adStatus |
EventStatusEnum. Wird WillChangeRecordset 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 RecordsetChangeComplete 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. Oder er wird auf adStatusCancel festgelegt, wenn der dem zuvor angenommenen WillChangeRecordset -Ereignis zugeordnete Vorgang abgebrochen wurde. Before WillChangeRecordset returns, set this parameter to adStatusCancel to request cancellation of the pending operation or set this parameter to adStatusUnwantedEvent to prevent subsequent notifications. Legen Sie diesen Parameter vor der Rückgabe von WillChangeRecordset oder RecordsetChangeComplete auf AdStatusUnwantedEvent fest, um nachfolgende Benachrichtigungen zu verhindern. |
| pError | Ein Error-Objekt. Es beschreibt den Fehler, der auftritt, wenn der Wert von adStatus auf adStatusErrorsOccurred festgelegt wird; andernfalls wird er nicht festgelegt. |
| pRecordset | Ein Recordset-Objekt. Das Recordset-Objekt, für das dieses Ereignis eingetreten ist. |
Hinweise
Ein WillChangeRecordset - oder ein RecordsetChangeComplete -Ereignis kann aufgrund der Methoden Requery oder Open des Recordset -Objekts eintreten.
Wenn der Anbieter Textmarken nicht unterstützt, tritt immer eine RecordsetChange -Ereignisbenachrichtigung auf, wenn neue Zeilen vom Anbieter abgerufen werden. Die Häufigkeit dieses Ereignisses hängt von der RecordsetCacheSize -Eigenschaft ab.
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.