Freigeben über


WillChangeRecordset- und RecordsetChangeComplete-Ereignisse (ADO)

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

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.

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 ist auf adStatusCantDeny festgelegt, wenn dieses Ereignis den Abbruch des ausstehenden Vorgangs nicht anfordern kann.

Wenn RecordsetChangeComplete- aufgerufen wird, wird dieser Parameter auf adStatusOK- festgelegt, wenn der Vorgang, der das Ereignis verursacht hat, erfolgreich war, adStatusErrorsOccurred, wenn der Vorgang fehlgeschlagen ist, oder adStatusCancel, wenn der zuvor akzeptierte Vorgang WillChangeRecordset Ereignis abgebrochen wurde.

Bevor WillChangeRecordset zurückgibt, legen Sie diesen Parameter auf adStatusCancel fest, um den Abbruch des ausstehenden Vorgangs anzufordern, oder legen Sie diesen Parameter auf adStatusUnwantedEvent fest, um nachfolgende Benachrichtigungen zu verhindern.

Bevor WillChangeRecordset oder RecordsetChangeComplete- zurückgegeben wird, legen Sie diesen Parameter auf adStatusUnwantedEvent- fest, um nachfolgende Benachrichtigungen zu verhindern.

pError-
Ein Error-Objekt. Es beschreibt den Fehler, der aufgetreten ist, wenn der Wert von adStatus-adStatusErrorsOccurredist; andernfalls ist sie nicht festgelegt.

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

Bemerkungen

Ein WillChangeRecordset-- oder RecordsetChangeComplete--Ereignis kann aufgrund der methoden RecordsetRequery oder Open auftreten.

Wenn der Anbieter keine Lesezeichen unterstützt, tritt jedes Mal, wenn neue Zeilen vom Anbieter abgerufen werden, eine RecordsetChange- Ereignisbenachrichtigung auf. Die Häufigkeit dieses Ereignisses hängt vom 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.

Siehe auch

ADO-Ereignismodell (Beispiel) (VC++)
ADO-Ereignishandlerzusammenfassung