AbsolutePosition プロパティ (ADO)AbsolutePosition Property (ADO)

序数位置を示す、 Recordsetオブジェクトの現在のレコード。Indicates the ordinal position of a Recordset object's current record.

設定と戻り値Settings and Return Values

32 ビット コードでは、設定または取得を長い内のレコードの数に 1 の値、レコード セットオブジェクト (RecordCount) のいずれかを返しますまたは、 PositionEnum値。For 32-bit code, sets or returns a Long value from 1 to the number of records in the Recordset object (RecordCount), or returns one of the PositionEnum values.

64 ビット コードでは、64 ビット値のストレージを提供するデータ型を使用します。For 64-bit code, use a data type that provides for storage of a 64-bit value. たとえば、時間の長いまたは別のいずれかを使用可能性があります DBORDINAL などの 64 ビット長の値します。For example, you might use either Long or another value that is 64-bit length such as DBORDINAL. 使用しないPositionEnum値を 32 ビットの長さに制限されているためです。Do not use PositionEnum values since they are limited to 32-bit length.


設定するには、 AbsolutePositionを使用する OLE DB プロバイダーを実装する必要がありますプロパティ、ADO、 IRowsetLocate:IRowsetインターフェイス。In order to set the AbsolutePosition property, ADO requires that the OLE DB provider you are using implement the IRowsetLocate:IRowset interface.

アクセス、 AbsolutePositionのプロパティをレコード セット順方向専用で開かれるされているか、動的カーソルは、エラーを発生させますadErrFeatureNotAvailableします。Accessing the AbsolutePosition property of a Recordset that was opened with either a forward-only or dynamic cursor raises the error adErrFeatureNotAvailable. OLE DB プロバイダーでサポートされていれば別のカーソルの種類では、正しい位置が返される、 IRowsetScroll:IRowsetLocateインターフェイス。With other cursor types, the correct position will be returned as long as the OLE DB provider supports the IRowsetScroll:IRowsetLocate interface. プロバイダーがサポートされていない場合、 IRowsetScrollインターフェイス、プロパティに設定がadPosUnknownします。If the provider does not support the IRowsetScroll interface, the property is set to adPosUnknown. サポートするかどうかを確認するには、プロバイダーのドキュメントを参照してIRowsetScrollします。See the documentation for your provider to determine whether it supports IRowsetScroll.

使用して、 AbsolutePosition内の序数位置に基づいて、レコードに移動するプロパティ、レコード セットオブジェクト、または現在のレコードの序数位置を決定します。Use the AbsolutePosition property to move to a record based on its ordinal position in the Recordset object, or to determine the ordinal position of the current record. プロバイダーは、このプロパティを使用するための適切な機能をサポートする必要があります。The provider must support the appropriate functionality for this property to be available.

ように、 AbsolutePageプロパティ、 AbsolutePositionは 1 に基づいており、現在のレコードが最初のレコードは 1 に等しい、 Recordsetします。Like the AbsolutePage property, AbsolutePosition is 1-based and equals 1 when the current record is the first record in the Recordset. 内のレコードの合計数を取得することができます、 Recordsetオブジェクトから、 RecordCountプロパティ。You can obtain the total number of records in the Recordset object from the RecordCount property.

設定すると、 AbsolutePositionプロパティ、現在のキャッシュ内のレコードになった場合でも ADO キャッシュに再読み込みを指定したレコードとレコードの新しいグループにします。When you set the AbsolutePosition property, even if it is to a record in the current cache, ADO reloads the cache with a new group of records starting with the record you specified. CacheSizeプロパティは、このグループのサイズを決定します。The CacheSize property determines the size of this group.


使用しないようにする、 AbsolutePositionプロパティ レコード番号の代わりにします。You should not use the AbsolutePosition property as a surrogate record number. 前のレコードを削除すると、特定のレコードの位置を変更します。The position of a given record changes when you delete a preceding record. またの特定のレコードと同じことが保証はありませんAbsolutePosition場合、レコード セットオブジェクトのクエリを再実行または再度開きます。There is also no assurance that a given record will have the same AbsolutePosition if the Recordset object is requeried or reopened. ブックマークが保持して、指定した位置に戻るをお勧めはあらゆる種類の配置の唯一の方法でありRecordsetオブジェクト。Bookmarks are still the recommended way of retaining and returning to a given position and are the only way of positioning across all types of Recordset objects.

適用対象Applies To

Recordset オブジェクト (ADO)Recordset Object (ADO)

参照See Also

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