共用方式為


Move 方法 (ADO)

將當前記錄的位置移至 Recordset 物件中。

語法

  
recordset.Move NumRecords, Start  

參數

NumRecords
帶正負號 Long 表示式,指定目前記錄位置移動的記錄數目。

開始
自選。 評估為書籤的 String 值或 Variant。 您也可以使用 BookmarkEnum 值。

言論

所有 Recordset 物件都支援 Move 方法。

如果 NumRecords 自變數大於零,則目前的記錄位置會往前移動(朝 Recordset的結尾移動)。 如果 NumRecords 小於零,則目前的記錄位置會向後移動(朝 Recordset的開頭)。

如果 Move 呼叫會將當前記錄位置移至第一筆記錄之前的點,ADO 會將當前記錄設定為記錄集內第一筆記錄之前的位置(BOFtrue)。 當 BOF 屬性已經 True 產生錯誤時,嘗試向後移動。

如果 Move 呼叫會將當前記錄位置移至最後一筆記錄之後的點,ADO 會將當前記錄設定為記錄集最後一筆記錄之後的位置(EOF 為 true )。 當 EOF 屬性已經 True 時,嘗試向前移動, 會產生錯誤。

從空 Recordset 呼叫 Move 方法, 物件會產生錯誤。

如果您傳遞 Start 自變數,移動會相對於具有此書籤的記錄,假設 Recordset 對象支援書籤。 如果未指定,移動會相對於當前記錄。

如果您使用 CacheSize 屬性從提供者本機快取記錄,則從目的地記錄開始,傳遞 NumRecords 自變數,將當前記錄位置移至目前快取記錄群組之外的位置,會強制 ADO 從目的地記錄擷取新的記錄群組。 CacheSize 屬性會決定新擷取群組的大小,而目的地記錄是擷取的第一筆記錄。

如果 Recordset 物件只轉寄,使用者仍然可以傳遞小於零的 NumRecords 自變數,前提是目的地位於目前快取的記錄集中。 如果 Move 呼叫會將當前記錄位置移至第一筆快取記錄之前的記錄,則會發生錯誤。 因此,您可以使用支援完整捲動的記錄快取,而提供者只支援向前捲動。 因為快取的記錄會載入記憶體中,因此您應該避免快取比必要更多的記錄。 即使順向 Recordset 物件以這種方式支援向後移動,在任何順向 Recordset 物件上呼叫 MovePrevious 方法仍會產生錯誤。

注意

視您的提供者而定,在僅向前 Recordset 中向後移動的支持是無法預測的。 如果目前記錄位於 Recordset的最後一筆記錄之後,Move 回溯可能不會產生正確的目前位置。

適用於

Recordset 物件 (ADO)

另請參閱

Move 方法範例 (VB)
Move 方法範例 (VBScript)
Move 方法範例 (VC++)
MoveFirst、MoveLast、MoveNext 和 MovePrevious 方法 (ADO)
MoveFirst、MoveLast、MoveNext 和 MovePrevious 方法 (RDS)
MoveRecord 方法 (ADO)