WillMove 和 MoveComplete 事件 (ADO)

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

語法

  
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 以要求解除擱置的作業，或將此參數設定為 adStatusUnwantedEvent 以防止後續通知。

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

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

備註

WillMove 或 MoveComplete 事件可能會因為下列 Recordset 作業而發生：Open、Move、MoveFirst、MoveLast、MoveNext、MovePrevious、AddNew 和 Requery。 這些事件可能是因為下列屬性而發生：Filter、Index、Bookmark、AbsolutePage 和 AbsolutePosition。 如果子 Recordset 已連接 Recordset 事件，且父 Recordset 有移動，也會發生這些事件。

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

另請參閱

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