WillMove and MoveComplete (RecordsetEvent) 方法


WillMove 方法在挂起操作更改 Recordset 中的当前位置前调用。MoveComplete 方法则在 Recordset 的当前位置更改后调用。

语法

WillMove adReason, adStatus, pRecordset

MoveComplete adReason, pError, adStatus, pRecordset

参数

adReason EventReasonEnum 值，指定该事件的原因。它的值可以是 adRsnMoveFirst、adRsnMoveLast、adRsnMoveNext、adRsnMovePrevious、adRsnMove 或 adRsnRequery。

pError Error 对象，说明当 adStatus 值为 adStatusErrorsOccurred 时所发生的错误，否则将不对它进行设置。

adStatus EventStatusEnum 状态值。

当调用 WillMove 时，如果引发事件的操作成功，则该参数设置为 adStatusOK。如果该方法无法请求取消挂起的操作，则设置为 adStatusCantDeny。

当调用 MoveComplete 时，如果引发事件的操作成功，则该参数设置为 adStatusOK。如果操作失败，则设置为 adStatusErrorsOccurred。

在 WillMove 返回前，将该参数设置为 adStatusCancel 可请求取消挂起的操作。在 MoveComplete 返回前，将该参数设置为 adStatusUnwantedEvent 可避免后续的通知。

pRecordset Recordset 对象。发生该事件所针对的记录集。

说明

WillMove 或 MoveComplete 事件可因下列 Recordset 操作而发生：Open、Move、MoveFirst、MoveLast、MoveNext、MovePrevious、Bookmark、AddNew、Delete、Requery 和 Resync。这些事件可能因下列属性而发生：Filter、Index、AbsolutePage 和 AbsolutePosition。如果子 Recordset 使 Recordset 事件被连接并且父 Recordset 被移动，则也会发生这些事件。