ADO WillMove 和 MoveComplete 事件
❮ Recordset 对象完整参考
WillMove 事件
WillMove 事件在操作改变 Recordset 中的当前位置之前触发。
注意: 在此事件返回之前,将 status 参数设置为 adStatusCancel 以取消导致此事件的操作,或将其设置为 adStatusUnwantedEvent 以阻止后续通知。
MoveComplete 事件
MoveComplete 事件在 Recordset 中的当前位置改变之后触发。
注意: 在此事件返回之前,将 status 参数设置为 adStatusUnwantedEvent 以阻止后续通知。
注意: 当调用以下 Recordset 方法之一时,可能会发生 WillMove 事件或 MoveComplete 事件:Open、Move、MoveFirst、MoveLast、MoveNext、MovePrevious、AddNew 和 Requery。 这些事件也可能由于以下属性而发生:Filter、Index、Bookmark、AbsolutePage 和 AbsolutePosition。
语法
WillMove reason,status,objRs
MoveComplete reason,objErr,status,objRs
参数 | 描述 |
---|---|
reason | 一个 EventReasonEnum 值,指定此事件的原因 |
status | 一个 EventStatusEnum 值,指示事件执行的状态 |
objErr | 如果 status 设置为 adStatusErrorsOccurred,则为描述错误的 Error 对象的名称,否则不设置 |
objRs | 触发此事件的 Recordset 对象的名称 |
EventReasonEnum 值
常量 | 值 | 描述 |
---|---|---|
adRsnRequery | 7 | 操作重新查询了 Recordset |
adRsnMove | 10 | 操作在 Recordset 中移动了记录指针 |
adRsnMoveFirst | 12 | 操作将记录指针移动到 Recordset 中的第一条记录 |
adRsnMoveNext | 13 | 操作将记录指针移动到 Recordset 中的下一条记录 |
adRsnMovePrevious | 14 | 操作将记录指针移动到 Recordset 中的上一条记录 |
adRsnMoveLast | 15 | 操作将记录指针移动到 Recordset 中的最后一条记录 |
EventStatusEnum 值
常量 | 值 | 描述 |
---|---|---|
adStatusOK | 1 | 导致事件的操作成功 |
adStatusErrorsOccurred | 2 | 导致事件的操作失败 |
adStatusCantDeny | 3 | 导致事件的操作无法取消 |
adStatusCancel | 4 | 导致事件的操作被取消 |
adStatusUnwantedEvent | 5 | 在事件方法执行完毕之前阻止后续通知 |
❮ Recordset 对象完整参考