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, and Requery。以下屬性也可能導致這些事件的發生:Filter, Index, Bookmark, AbsolutePage, and 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 物件參考