WillChangeRecordset- und RecordsetChangeComplete-Ereignis (ADO)

  • Artikel

Das WillChangeRecordset-Ereignis wird aufgerufen, bevor ein ausstehender Vorgang das Recordset ändert. Das RecordsetChangeComplete-Ereignis wird aufgerufen, nachdem das Recordset geändert wurde.

Syntax

  
WillChangeRecordset adReason, adStatus, pRecordset  
RecordsetChangeComplete adReason, pError, adStatus, pRecordset

Parameter

adReason
Ein EventReasonEnum-Wert, der den Grund für dieses Ereignis angibt. Der Wert kann adRsnRequery, adRsnResynch, adRsnClose, adRsnOpen sein.

adStatus
Ein EventStatusEnum-Statuswert.

Wenn WillChangeRecordset 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 RecordsetChangeComplete aufgerufen wird, wird dieser Parameter auf adStatusOK festgelegt, wenn der Vorgang, der das Ereignis verursacht hat, erfolgreich war, auf adStatusErrorsOccurred, wenn der Vorgang fehlgeschlagen ist, oder auf adStatusCancel, wenn der Vorgang, der dem zuvor akzeptierten WillChangeRecordset-Ereignis zugeordnet ist, abgebrochen wurde.

Legen Sie diesen Parameter vor dem Zurückgeben von WillChangeRecordset auf adStatusCancel fest, um den Abbruch des ausstehenden Vorgangs anzufordern, oder legen Sie diesen Parameter auf „adStatusUnwantedEvent“ fest, um nachfolgende Benachrichtigungen zu verhindern.

Legen Sie diesen Parameter vor dem Zurückgeben von WillChangeRecordset oder RecordsetChangeComplete auf adStatusUnwantedEvent fest, um nachfolgende Benachrichtigungen zu verhindern.

pError
Ein Error-Objekt. Dieser Parameter enthält eine Beschreibung des aufgetretenen Fehlers, wenn adStatus den Wert adStatusErrorsOccurred aufweist. Andernfalls ist er nicht festgelegt.

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

Hinweise

Ein WillChangeRecordset - oder RecordsetChangeComplete-Ereignis kann aufgrund der Methoden "Recordset Requery " oder "Open " auftreten.

Wenn der Anbieter keine Textmarken unterstützt, erfolgt jedes Mal eine RecordsetChange-Ereignisbenachrichtigung, 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 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 – Zusammenfassung