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

内のレコードの数を示す、 Recordsetオブジェクト。Indicates the number of records in a Recordset object.

戻り値Return Value

返します、長い内のレコードの数を示す値、 Recordsetします。Returns a Long value that indicates the number of records in the Recordset.

コメントRemarks

使用して、 RecordCountでレコードの数を確認するプロパティには、レコード セットオブジェクト。Use the RecordCount property to find out how many records are in a Recordset object. プロパティは、ADO レコードの数を判断できない場合、または、プロバイダーまたはカーソルの種類がサポートされていない場合に-1 を返しますRecordCountします。The property returns -1 when ADO cannot determine the number of records or if the provider or cursor type does not support RecordCount. 読み取り、 RecordCountプロパティを閉じているRecordsetエラーが発生します。Reading the RecordCount property on a closed Recordset causes an error.

ブックマークまたは概数の配置Bookmarks or approximate positioning

場合、レコード セット オブジェクトいずれかのブックマークをサポートまたは概数配置、このプロパティを返しますレコード数の正確なレコード セット。If the Recordset object does support either bookmarks or approximate positioning, this property returns the exact number of records in the Recordset. このプロパティは、レコード セットに完全設定がされるかどうかに関係なく正確な数を返します。This property returns the exact number regardless of whether the Recordset has been fully populated.

これに対して、レコード セット オブジェクトはいないブックマークまたはおおよその位置のいずれかをサポートして、このプロパティにアクセスがリソースを大量消費する可能性があります。In contrast, if the Recordset object does not support either bookmarks or approximate positioning, accessing this property might be a significant drain on resources. ドレインでは、すべてのレコードが取得する必要があり、正確な RecordCount の値を返すをカウントするために発生します。The drain occurs because all records must retrieved and counted to return an accurate RecordCount value.

  • adBookmarkに関連するブックマーク。adBookmark related to bookmarks.
  • adApproxPositionおおよその位置に関連しています。adApproxPosition relates to approximate positioning.

注意

返されるという事実に関係なく、サーバー側カーソルを使用すると ADO version 2.8 およびそれ以前では、SQLOLEDB プロバイダーがすべてのレコードをフェッチTrue両方のサポート (adApproxPosition)サポート (adBookmark) します。In ADO versions 2.8 and earlier, the SQLOLEDB provider fetches all records when a server-side cursor is used, despite the fact that it returns True for both Supports (adApproxPosition) and Supports (adBookmark).

カーソルの種類、 Recordsetオブジェクトは、レコードの数を決定できるかどうかに影響します。The cursor type of the Recordset object affects whether the number of records can be determined. RecordCountプロパティは順方向専用カーソルは実際の数、静的なキーセット カーソルといずれか-1 の場合は-1 または動的カーソルのデータ ソースによっては、実際の数を返します。The RecordCount property will return -1 for a forward-only cursor; the actual count for a static or keyset cursor; and either -1 or the actual count for a dynamic cursor, depending on the data source.

適用対象Applies To

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

関連項目See Also

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