Move メソッド (ADO)

適用先: Access 2013、Office 2013

Recordset オブジェクトでカレント レコードの位置を移動します。

構文

recordset。 NumRecords の移動、 開始

パラメーター

注釈

Move メソッドは、すべての Recordset オブジェクトでサポートされています。

NumRecords 引数がゼロより大きい場合、現在のレコードの位置は前方 (Recordset の末尾方向) に移動します。 NumRecords がゼロより小さい場合、現在のレコードの位置は後方 (Recordset の先頭方向) に移動します。

Move 呼び出しが現在のレコード位置を最初のレコードの前のポイントに移動する場合、ADO は現在のレコードをレコードセットの最初のレコードの前の位置に設定します (BOF は True)。 BOF プロパティが既に True の場合、後方へ移動しようとすると、エラーが発生します。

Move メソッドを呼び出してカレント レコードの位置を最後のレコードの後に移動しようとすると、カレント レコードがレコードセットの最後のレコードの後に設定され、EOF が True になります。 EOF プロパティが既に True の場合、前方へ移動しようとすると、エラーが発生します。

空の Recordset オブジェクトから Move メソッドを呼び出すと、エラーが発生します。

Start 引数を指定した場合、Recordset オブジェクトではブックマークがサポートされていると見なされ、このブックマークを持つレコードが移動の基準となります。 指定しない場合は、カレント レコードが移動の基準となります。

CacheSize プロパティを使用してプロバイダーからのレコードをローカルにキャッシュしている場合、NumRecords 引数を渡して、現在キャッシュされているレコード グループの範囲外に現在のレコード位置を移動すると、移動先のレコードから始まる新規レコード グループが強制的に取得されます。 新しく取り込まれるグループのサイズは CacheSize プロパティによって決まり、移動先のレコードが最初に取得されるレコードになります。

Recordset オブジェクトが前方スクロールのみ可能な場合でも、移動先が現在キャッシュされているレコードセットの範囲内であれば、NumRecords 引数に 0 より小さい値を指定できます。 Move メソッドを呼び出して、カレント レコードの位置を、キャッシュされている最初のレコードより前のレコードに移動しようとすると、エラーが発生します。 このように、前方スクロールのみをサポートするプロバイダーで、完全スクロールをサポートするレコード キャッシュを使用することができます。 キャッシュされたレコードはメモリに読み込まれるため、必要以上のレコードのキャッシュは避けてください。 前方スクロールのみ可能な Recordset オブジェクトでも、この方法で後方への移動をサポートできますが、前方スクロールのみ可能な Recordset オブジェクトで MovePrevious メソッドを呼び出すと、エラーが発生します。