ADO事件之(8)---WillChangeRecord 和 RecordChangeComplete (Records

WillChangeRecord 和 RecordChangeComplete (RecordsetEvent) 方法


WillChangeRecord 方法在 Recordset 中的一個或多個記錄（行）更改之前調用。RecordChangeComplete 方法在一個或多個記錄更改之后調用。

語法

WillChangeRecord adReason, cRecords, adStatus, pRecordset

RecordChangeComplete adReason, cRecords, pError, adStatus, pRecordset

參數

adReason EventReasonEnum 值，指定該事件的原因。它的值可以是 adRsnAddNew、adRsnDelete、adRsnUpdate、adRsnUndoUpdate、adRsnUndoAddNew、adRsnUndoDelete 或 adRsnFirstChange。

cRecords 長整型，更改（影響）的記錄數目。

pError Error 對象，說明當 adStatus 值為 adStatusErrorsOclearcase/" target="_blank" >ccurred 時所發生的錯誤，否則將不對它進行設置。

adStatus EventStatusEnum 狀態值。

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

當調用 RecordChangeComplete 時，如果引發事件的操作成功，則該參數設置為 adStatusOK。如果操作失敗，則設置為 adStatusErrorsOccurred。

在 WillChangeRecord 返回前，將該參數設置為 adStatusCancel 可請求取消引發該事件的操作。

在 RecordChangeComplete 返回前，將該參數設置為 adStatusUnwantedEvent 可防止后續的通知。

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

說明

WillChangeRecord 或 RecordChangeComplete 事件可因下列 Recordset 操作并針對行中第一個更改的字段發生：Update、Delete、CancelUpdate、AddNew、UpdateBatch 和 CancelBatch。Recordset CursorType 的值決定了是哪一個操作導致事件發生。

在 WillChangeRecord 事件期間，Recordset Filter 屬性設置為 adFilterAffectedRecords。在處理事件時更改該屬性是不合法的。

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