共用方式為


WillMove 和 MoveComplete 事件 (ADO)

WillMove 事件會在暫止作業變更 recordset 中目前的位置之前呼叫。 MoveComplete 事件會在 Recordset 中的目前位置 變更之後呼叫。

語法

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

參數

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

pError
Error 物件。 它會描述如果 adStatus adStatusErrorsOccurred時所發生的錯誤;否則不會設定 參數。

adStatus
EventStatusEnum 狀態值。

呼叫willMove 時,如果造成事件的作業成功,此參數會設定為 adStatusOK。 如果此事件無法要求取消暫止作業,則會設定為 adStatusCantDeny

呼叫 moveComplete 時,如果造成事件的作業成功,則此參數會設定為 adStatusOK,或 失敗的 adStatusErrorsOccurred

WillMove 傳回之前,請將此參數設定為 adStatusCancel 要求取消暫止作業,或將此參數設定為 adStatusUnwantedEvent 以防止後續通知。

MoveComplete 傳回之前,請將此參數設定為 adStatusUnwantedEvent 以防止後續通知。

pRecordset
Recordset 物件。 發生此事件的 Recordset

言論

WillMoveMoveComplete 事件可能會因為下列 Recordset 作業而發生:OpenMoveMoveFirstMoveLastMoveNextMovePreviousAddNewRequery。 這些事件可能會因為下列屬性而發生:FilterIndexBookmarkAbsolutePageAbsolutePosition。 如果 Recordset 的子系 Recordset 事件已連線,而且移動 Recordset 的父,也會發生這些事件。

您必須針對每個可能 adReason 值,將 adStatus 參數設定為 adStatusUnwantedEvent,才能針對包含 adReason 參數的任何事件完全停止事件通知。

另請參閱

ADO 事件模型範例 (VC++)
ADO 事件處理程式摘要
Recordset 物件 (ADO)