最新的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 防止后续的通知之前的事件方法执行结束

<完整记录对象参考