WillMove 和 MoveComplete 事件 (ADO)

在挂起的操作更改 Recordset中的当前位置之前,调用 WillMove 事件。 MoveComplete 事件在 Recordset 中的当前位置 更改后调用。

语法

  
WillMove adReason, adStatus, pRecordset  
MoveComplete adReason, pError, adStatus, pRecordset  

参数

adReason
EventReasonEnum 值,该值指定此事件的原因。 其值 可以是 adRsnMoveFirstadRsnMoveLastadRsnMoveNextadRsnMovePreviousadRsnMoveadRsnRequery

pError
错误 对象。 它描述 adStatus 的值 adStatusErrorsOccurred时发生的错误;否则,未设置参数。

adStatus
EventStatusEnum 状态值。

调用 WillMove 时,如果导致事件的操作成功,此参数将设置为 adStatusOK。 如果此事件无法请求取消挂起的操作,则会将其设置为 adStatusCantDeny

调用 moveComplete 时,如果导致事件的操作成功,或 adStatusErrorsOccurred 如果操作失败,此参数将设置为 adStatusErrorsOccurred

WillMove 返回之前,请将此参数设置为 adStatusCancel 请求取消挂起的操作,或将此参数设置为 adStatusUnwantedEvent 以防止后续通知。

MoveComplete 返回之前,请将此参数设置为 adStatusUnwantedEvent 以防止后续通知。

pRecordset
Recordset 对象。 发生此事件的 Recordset

言论

由于以下 记录集 操作,WillMoveMoveComplete 事件发生:OpenMoveMoveFirstMoveLastMoveNextMovePreviousAddNewRequery。 这些事件可能由于以下属性而发生:FilterIndexBookmarkAbsolutePageAbsolutePosition。 如果子 Recordset 已连接记录集 事件 且移动父 Recordset,则也会发生这些事件。

必须为每个可能的 adReason 值将 adStatus 参数设置为 adStatusUnwantedEvent,才能针对包含 adReason 参数的任何事件完全停止事件通知。

另请参阅

ADO 事件模型示例 (VC++)
ADO 事件处理程序摘要
Recordset 对象 (ADO)