WillChangeRecordset 和 RecordsetChangeComplete (RecordsetEvent) 事件

WillChangeRecordset 和 RecordsetChangeComplete (RecordsetEvent) 事件

   

WillChangeRecordset 方法在掛起操作更改 Recordset 之前調(diào)用。RecordsetChangeComplete 方法在 Recordset 更改后調(diào)用。

語法

WillChangeRecordset adReason, adStatus, pRecordset

RecordsetChangeComplete adReason, pError, adStatus, pRecordset

參數(shù)

adReason   EventReasonEnum 值，指定該事件的原因。它的值可以是 adRsnReQuery、adRsnReSynch、adRsnClose、adRsnOpen。

adStatus   EventStatusEnum 狀態(tài)值。

當調(diào)用 WillChangeRecordset 時，如果引發(fā)事件的操作成功，則該參數(shù)設(shè)置為 adStatusOK。如果該方法無法請求取消掛起的操作，則設(shè)置為 adStatusCantDeny。

當調(diào)用 RecordsetChangeComplete 時，如果引發(fā)事件的操作成功，則該參數(shù)設(shè)置為 adStatusOK；如果操作失敗，則設(shè)置為 adStatusErrorsOccurred；如果與以前接受的 WillChangeRecordset 事件關(guān)聯(lián)的操作已經(jīng)取消，則設(shè)置為 adStatusCancel。

在 WillChangeRecordset 返回前，將該參數(shù)設(shè)置為 adStatusCancel 以請求取消掛起操作。

在 WillChangeRecordset 或 RecordsetChangeComplete 返回前，將該參數(shù)設(shè)置為 adStatusUnwantedEvent 可避免后續(xù)的通知。

pError   Error 對象，說明當 adStatus 值為 adStatusErrorsOccurred 時所發(fā)生的錯誤，否則將不對它進行設(shè)置。

pRecordset   Recordset 對象，發(fā)生該事件所針對的記錄集。

說明

WillChangeRecordset 或 RecordsetChangeComplete 事件可因下列 Recordset 操作而發(fā)生：Requery 和 Open。

如果提供者不支持書簽，則每次從提供者處檢索新行時發(fā)生 RecordsetChange 事件通知。該事件的頻率取決于 RecordsetCacheSize 屬性。