ADO WillChangeRecord 和 RecordChangeComplete 事件
❮ 记录集对象参考完整列表
WillChangeRecord 事件
WillChangeRecord 事件在一条或多条记录发生更改之前触发。
注意: 在此事件返回之前,将 status 参数设置为 adStatusCancel 以取消导致此事件的操作,或将其设置为 adStatusUnwantedEvent 以阻止后续通知。
RecordChangeComplete 事件
RecordChangeComplete 事件在一条或多条记录发生更改之后触发。
注意: 在此方法返回之前,将 status 参数设置为 adStatusUnwantedEvent 以阻止后续通知。
注意: 如果你使用以下记录集操作之一更改记录中的字段,则可能会发生 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 | 在事件方法完成执行之前阻止后续通知 |
❮ 记录集对象参考完整列表