ADO事件之(9)---WillChangeRecordset 和 RecordsetChangeComplete (R

WillChangeRecordset 和 RecordsetChangeComplete (RecordsetEvent) 事件


WillChangeRecordset 方法在掛起操作更改 Recordset 之前調用。RecordsetChangeComplete 方法在 Recordset 更改后調用。

語法

WillChangeRecordset adReason, adStatus, pRecordset

RecordsetChangeComplete adReason, pError, adStatus, pRecordset

參數

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

adStatus EventStatusEnum 狀態值。

當調用 WillChangeRecordset 時，如果引發事件的操作成功，則該參數設置為 adStatusOK。如果該方法無法請求取消掛起的操作，則設置為 adStatusCantDeny。

當調用 RecordsetChangeComplete 時，如果引發事件的操作成功，則該參數設置為 adStatusOK；如果操作失敗，則設置為 adStatusErrorsOclearcase/" target="_blank" >ccurred；如果與以前接受的 WillChangeRecordset 事件關聯的操作已經取消，則設置為 adStatusCancel。

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

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

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

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

說明

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

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

原文轉自：http://www.kjueaiud.com