AbsolutePosition プロパティ (ADO)

Recordset オブジェクトの現在のレコードの序数で表される位置を示します。

設定と戻り値

32 ビット コードの場合、Long 値に 1 から Recordset オブジェクト内のレコードの数 (RecordCount) までを設定または返すか、PositionEnum 値のいずれかを返します。

64 ビット コードの場合は、64 ビット値のストレージ用に指定するデータ型を使用します。 たとえば、Long や、DBORDINAL などの 64 ビット長の別の値を使用できます。 PositionEnum 値は 32 ビット長に制限されているため、使用しないでください。

注釈

AbsolutePosition プロパティを設定するために、ADO は、使用している OLE DB プロバイダーが IRowsetLocate:IRowset インターフェイスを実装することを要求します。

前方のみのカーソルまたは動的カーソルで開かれた Recordset の AbsolutePosition プロパティにアクセスすると、エラー adErrFeatureNotAvailable が発生します。 他のカーソルの種類では、OLE DB プロバイダーが IRowsetScroll:IRowsetLocate インターフェイスをサポートしている限り、正しい位置が返されます。 プロバイダーが IRowsetScroll インターフェイスをサポートしていない場合、このプロパティは adPosUnknown に設定されます。 プロバイダーが IRowsetScroll をサポートしているかどうかを確認するには、プロバイダーのドキュメントを参照してください。

AbsolutePosition プロパティを使用して、Recordset オブジェクト内の序数の位置に基づいてレコードに移動するか、現在のレコードの序数の位置を決定します。 プロバイダーは、このプロパティを使用できるようにするための適切な機能をサポートする必要があります。

AbsolutePage プロパティと同様に、AbsolutePosition は 1 をベースとし、現在のレコードが Recordset の最初のレコードの場合は 1 になります。 RecordCount プロパティから Recordset オブジェクト内のレコードの合計数を取得できます。

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

注意

代理レコード番号として AbsolutePosition プロパティを使用しないでください。 前のレコードを削除すると、特定のレコードの位置が変わります。 また、Recordset オブジェクトが再クエリまたは再開された場合、特定のレコードが同じ AbsolutePosition を持つことも保証されません。 ブックマークは、引き続き特定の位置を保持して戻るための推奨される方法であり、すべての種類の Recordset オブジェクトで位置を指定する唯一の方法です。

適用対象

Recordset オブジェクト (ADO)

参照

AbsolutePosition および CursorLocation プロパティの例 (VB)
AbsolutePosition および CursorLocation プロパティの例 (VC++)
AbsolutePage プロパティ (ADO)
RecordCount プロパティ (ADO)