Move メソッド (ADO)

Recordset オブジェクト内の現在のレコードの位置を 移動 します。

構文

  
recordset.Move NumRecords, Start  

パラメーター

NumRecords
現在の レコード位置 が移動するレコードの数を指定する署名付き Long 式。

Start
省略可能。 ブックマーク 評価 される String 値または Variant。 BookmarkEnum 値を使用できます。

解説

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

NumRecords 引数が 0 より大きい場合、現在のレコード位置は (レコードセットの末尾に向かって) 前方に移動 しますNumRecords が 0 未満の場合、現在のレコード位置は (レコードセットの先頭に向かって) 後方に移動 します

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

Move 呼び出しによって現在のレコード位置が最後のレコードの後のポイントに移動される場合、ADO はレコードセット内の最後のレコードの後の位置に現在のレコードを設定します (EOFTrue)。 EOF プロパティが既に True の場合に先に進 もうとすると、エラーが生成されます。

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

Start 引数を渡した場合、レコード セット オブジェクトでブックマークがサポートされている場合、移動は、このブックマークを持つレコードに対して相対的です。 指定しない場合、移動は現在のレコードに対して相対的です。

CacheSizeプロパティを使用してプロバイダーからレコードをローカルにキャッシュする場合、現在のレコード位置をキャッシュされたレコードの現在のグループの外部に移動する NumRecords 引数を渡す場合、ADO はコピー先レコードから始まる新しいレコード グループを取得する必要があります。 CacheSize プロパティは、新しく取得されたグループのサイズを決定し、コピー先レコードは最初に取得したレコードです。

レコードセット オブジェクトが 前方にのみ存在する場合、ユーザーは、コピー先がキャッシュされたレコードの現在のセット内にある場合、0 未満の NumRecords 引数を渡す可能性があります。 Move 呼 び出 しで現在のレコード位置を最初のキャッシュ されたレコードの前のレコードに移動すると、エラーが発生します。 したがって、前方スクロールのみをサポートするプロバイダーの完全スクロールをサポートするレコード キャッシュを使用できます。 キャッシュされたレコードはメモリに読み込まれるため、必要以上に多くのレコードをキャッシュしないようにする必要があります。 前方専用レコードセット オブジェクトでこの方法で後方移動がサポートされている場合でも、前方専用 レコード セット オブジェクトで MovePreviousメソッドを呼び出しても、エラーが発生します。

注意

前方専用レコードセット内で後方に移動するサポートは、プロバイダーによっては予測できません。 レコードセット の最後のレコードの後に現在のレコードが配置されている場合、後方に移動すると、現在の位置が正しく表示されない可能性があります。

適用対象

Recordset オブジェクト (ADO)

参照

Move メソッドの例 (VB)
Move メソッドの例 (VBScript)
Move メソッドの例 (VC++)
MoveFirst、MoveLast、MoveNext、MovePrevious メソッド (ADO)
MoveFirst、MoveLast、MoveNext、MovePrevious メソッド (RDS)
MoveRecord メソッド (ADO)