共用方式為


WillChangeRecordset 和 RecordsetChangeComplete 事件 (ADO)

在擱置的作業變更 Recordset 之前,會呼叫 WillChangeRecordset 事件。 RecordsetChangeComplete 事件會在 Recordset 變更之後呼叫。

語法

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

參數

adReason
EventReasonEnum值,指定此事件的原因。 其值可以是 adRsnRequeryadRsnResynchadRsnCloseadRsnOpen

adStatus
EventStatusEnum 狀態值。

呼叫 WillChangeRecordset 時,如果造成事件的作業成功,此參數會設定為 adStatusOK。 如果此事件無法要求解除擱置的作業,便會設定為 adStatusCantDeny

呼叫 RecordsetChangeComplete 時,如果造成事件的作業成功,則此參數會設定為 adStatusOK、如果作業失敗,則為 adStatusErrorsOccurred,如果先前接受的 WillChangeRecordset 事件相關聯作業已取消,則為 adStatusCancel

WillChangeRecordset 傳回之前,請將此參數設定為 adStatusCancel 以要求解除擱置的作業,或將此參數設定為 adStatusUnwantedEvent 以防止後續通知。

WillChangeRecordsetRecordsetChangeComplete 傳回之前,請將此參數設定為 adStatusUnwantedEvent 以防止後續通知。

pError
Error 物件。 該物件會描述如果adStatus 值為 adStatusErrorsOccurred 時所發生的錯誤;否則不會設定。

pRecordset
Recordset 物件。 發生此事件的 Recordset

備註

WillChangeRecordset 或 RecordsetChangeComplete 事件可能會因為 Recordset RequeryOpen 方法而發生。

如果提供者不支援書簽,則每次從提供者擷取新資料列時,都會發生 RecordsetChange 事件通知。 此事件的頻率取決於 RecordsetCacheSize 屬性。

您必須針對每個可能的 adReason 值將 adStatus 參數設定為 adStatusUnwantedEvent,才能針對包含 adReason 參數的任何事件完全停止事件通知。

另請參閱

ADO 事件模型範例 (VC++)
ADO 事件處理常式摘要