AbsolutePosition プロパティ (ADO)

適用先: Access 2013、Office 2013

Recordset オブジェクト内のカレント レコードの位置を表す値を示します。

設定と戻り値

1 から Recordset オブジェクトのレコード数 (RecordCount) までの長整数型 (Long) の値を設定するか、または PositionEnum 値の 1 つを取得します。

注釈

AbsolutePosition プロパティを設定するには、使用している OLE DB プロバイダーが IRowsetLocate インターフェイスを実装する必要があります。

Accessing the AbsolutePosition property of a Recordset that was opened with either a forward-only or dynamic cursor raises the error adErrFeatureNotAvailable. With other cursor types, the correct position will be returned as long as the provider supports the IRowsetScroll interface. プロバイダーが IRowsetScroll インターフェイスをサポートしていない場合、プロパティは adPosUnknown に設定されます。 IRowsetScroll がサポートされているかどうかを判断するには、プロバイダーのドキュメントを参照してください。

AbsolutePosition プロパティを使用すると、 Recordset オブジェクトでのレコードの順序位置に基づいて特定のレコードに移動したり、カレント レコードの順序位置を調べたりできます。 このプロパティを使用するには、プロバイダーが必要な機能をサポートしている必要があります。

AbsolutePosition は、 AbsolutePage プロパティと同じく 1 から始まる値で、 Recordset の先頭レコードがカレント レコードの場合に 1 になります。 Recordset オブジェクトのレコード総数は、 RecordCount プロパティから取得できます。

AbsolutePosition プロパティを設定すると、現在のキャッシュ内のレコードであっても、ADO は指定したレコードから始まるレコードの新しいグループでキャッシュを再読み込みします。 CacheSize プロパティにより、このグループのサイズが決定されます。

注:

[!メモ] 代替レコード番号として AbsolutePosition プロパティを使用することはできません。 レコードの位置は、それより前のレコードが削除されると変わります。 また、 Recordset オブジェクトを照会し直したり、開き直したりした場合、同じレコードの AbsolutePosition が以前と同じになる保証はありません。 ブックマークは、引き続き特定の位置を保持して戻す推奨される方法であり、すべての種類の Recordset オブジェクト間で配置する唯一の方法です。