ADO WillChangeRecord 和 RecordChangeComplete 事件
❮ 完整的 Recordset 物件參考
WillChangeRecord 事件
WillChangeRecord 事件在一條或多條記錄更改之前觸發。
注意:在此事件返回之前,將 status 引數設定為 adStatusCancel 可以取消導致此事件的操作,或將其設定為 adStatusUnwantedEvent 以防止後續通知。
RecordChangeComplete 事件
RecordChangeComplete 事件在一條或多條記錄更改之後觸發。
注意:在此方法返回之前,將 status 引數設定為 adStatusUnwantedEvent 以防止後續通知。
注意:如果您使用以下 Recordset 操作之一更改記錄中的欄位,則可能會發生 WillChangeRecord 事件或 RecordChangeComplete 事件:Update、Delete、CancelUpdate、AddNew、UpdateBatch 和 CancelBatch。
語法
WillChangeRecord reason,numrec,status,objRs
RecordChangeComplete reason,numrec,objErr,status,objRs
引數 | 描述 |
---|---|
reason | 一個 EventReasonEnum 值,指定此事件的原因 |
numrec | 指示受影響的記錄數 |
status | 一個 EventStatusEnum 值,指示事件執行的狀態 |
objErr | 如果 status 設定為 adStatusErrorsOccurred,則描述錯誤的 Error 物件的名稱,否則未設定 |
objRs | 觸發此事件的 Recordset 物件的名稱 |
EventReasonEnum 值
常量 | 值 | 描述 |
---|---|---|
adRsnAddNew | 1 | 一個操作添加了一條新記錄 |
adRsnDelete | 2 | 一個操作刪除了記錄 |
adRsnUpdate | 3 | 一個操作更新了現有記錄 |
adRsnUndoUpdate | 4 | 一個操作撤銷了記錄的更新 |
adRsnUndoAddNew | 5 | 一個操作撤銷了新記錄的新增 |
adRsnUndoDelete | 6 | 一個操作撤銷了記錄的刪除 |
adRsnFirstChange | 11 | 一個操作對記錄進行了首次更改 |
EventStatusEnum 值
常量 | 值 | 描述 |
---|---|---|
adStatusOK | 1 | 導致事件的操作成功 |
adStatusErrorsOccurred | 2 | 導致事件的操作失敗 |
adStatusCantDeny | 3 | 導致事件的操作無法取消 |
adStatusCancel | 4 | 導致事件的操作已取消 |
adStatusUnwantedEvent | 5 | 在事件方法執行完成之前阻止後續通知 |
❮ 完整的 Recordset 物件參考