ADO WillChangeRecordRecordChangeComplete 事件


❮ 完整的 Recordset 记录集对象参考

WillChangeRecord 事件

WillChangeRecord 事件在一个或多个记录更改之前触发。

注释: 在此事件返回之前,将状态参数设置为 adStatusCancel 以取消导致此事件的操作或将其设置为 adStatusUnwantedEvent 以防止后续通知。

RecordChangeComplete 事件

RecordChangeComplete 事件在一条或多条记录被更改后触发。

注释: 在此方法返回之前,将状态参数设置为 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 触发此事件的记录集对象的名称

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 记录集对象参考