WillChangeRecord 和 RecordChangeComplete (RecordsetEvent) 方法

WillChangeRecord 和 RecordChangeComplete (RecordsetEvent) 方法

   

WillChangeRecord 方法在 Recordset 中的一個(gè)或多個(gè)記錄（行）更改之前調(diào)用。RecordChangeComplete 方法在一個(gè)或多個(gè)記錄更改之后調(diào)用。

語(yǔ)法

WillChangeRecord adReason, cRecords, adStatus, pRecordset

RecordChangeComplete adReason, cRecords, pError, adStatus, pRecordset

參數(shù)

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

cRecords   長(zhǎng)整型，更改（影響）的記錄數(shù)目。

pError   Error 對(duì)象，說(shuō)明當(dāng) adStatus 值為 adStatusErrorsOccurred 時(shí)所發(fā)生的錯(cuò)誤，否則將不對(duì)它進(jìn)行設(shè)置。

adStatus   EventStatusEnum 狀態(tài)值。

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

當(dāng)調(diào)用 RecordChangeComplete 時(shí)，如果引發(fā)事件的操作成功，則該參數(shù)設(shè)置為 adStatusOK。如果操作失敗，則設(shè)置為 adStatusErrorsOccurred。

在 WillChangeRecord 返回前，將該參數(shù)設(shè)置為 adStatusCancel 可請(qǐng)求取消引發(fā)該事件的操作。

在 RecordChangeComplete 返回前，將該參數(shù)設(shè)置為 adStatusUnwantedEvent 可防止后續(xù)的通知。

pRecordset   Recordset 對(duì)象，發(fā)生該事件所針對(duì)的 Recordset。

說(shuō)明

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

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