ADO WillChangeRecord 和 RecordChangeComplete 事件
❮ 完整的 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 记录集对象参考