最新的Web開發教程
 

ADO的WillChangeRecord和RecordChangeComplete活動


<完整記錄對象參考

該WillChangeRecord事件

該WillChangeRecord事件之前的一個或多個記錄的變化觸發。

Note:本次活動返回之前,設置狀態參數為adStatusCancel取消導致此事件的操作或將其設置為adStatusUnwantedEvent可避免後續notications。

該RecordChangeComplete事件

在一個或多個記錄已被更改時,會觸發事件RecordChangeComplete。

Note:此方法返回之前,狀態參數設置為adStatusUnwantedEvent可避免後續的通知。

Note:更新,刪除,CancelUpdate,的AddNew,的UpdateBatch和CancelBatch:如果您在使用下面的記錄操作的一個記錄更改字段可能會出現WillChangeRecord事件或RecordChangeComplete事件。

句法

WillChangeRecord reason,numrec,status,objRs

RecordChangeComplete reason,numrec,objErr,status,objRs

參數 描述
reason 一個EventReasonEnum值,指定該事件的原因
numrec 指明了受影響的記錄數
status 一個EventStatusEnum值,表示事件的執行狀態
objErr 描述錯誤,如果狀態設置為adStatusErrorsOccurred Error對象的名稱,否則未設置
objRs 觸發此事件的Recordset對象的名稱

EventReasonEnum值

不變 描述
adRsnAddNew1 操作增加了一個新的記錄
adRsnDelete2 操作刪除的記錄
adRsnUpdate3 操作更新現有記錄
adRsnUndoUpdate4 操作逆轉記錄的更新
adRsnUndoAddNew5 操作扭轉了另外一個新紀錄
adRsnUndoDelete6 操作扭轉了記錄的刪除
adRsnFirstChange11 操作第一個變化,達到創紀錄

EventStatusEnum值

不變 描述
adStatusOK1 引發該事件的操作成功
adStatusErrorsOccurred2 導致此事件的操作失敗
adStatusCantDeny3 導致此事件的操作無法取消
adStatusCancel4 引起該事件的操作被取消
adStatusUnwantedEvent5 防止後續的通知之前的事件方法執行結束

<完整記錄對象參考