RecordCount プロパティ (ADO)
Recordset オブジェクト内のレコードの数を示します。
戻り値
Recordset内のレコードの数を示す長い の 値を返します。
備考
Recordset オブジェクト内のレコードの数を調べるには、RecordCount プロパティを使用します。 このプロパティは、ADO がレコードの数を判断できない場合、またはプロバイダーまたはカーソルの種類が RecordCount サポートしていない場合に -1 を返します。 閉じた Recordset で RecordCount プロパティを読み取ると、エラーが発生します。
ブックマークまたはおおよその位置
Recordset オブジェクト がブックマークまたは近似位置をサポート 場合、このプロパティは Recordset 内のレコードの正確な数を返します。 このプロパティは、Recordset が完全に設定されているかどうかに関係なく、正確な数を返します。
これに対し、Recordset オブジェクト ブックマークまたはおおよその位置指定をサポート しない場合、このプロパティにアクセスすると、リソースが大幅に消費される可能性があります。 ドレインは、正確な RecordCount 値を返すために、すべてのレコードを取得してカウントする必要があるために発生します。
- ブックマークに関連する adBookmark を します。
- adApproxPosition は、おおよその配置に関連します。
手記
ADO バージョン 2.8 以前では、SQLOLEDB プロバイダーは、Supports (adApproxPosition) と Supports (adBookmark)の両方に対して True を返すにもかかわらず、サーバー側カーソルを使用するとすべてのレコードをフェッチします。
Recordset オブジェクトのカーソルの種類は、レコードの数を決定できるかどうかに影響します。 RecordCount プロパティは、順方向専用カーソルの -1 を返します。静的カーソルまたはキーセット カーソルの実際の数。データ ソースに応じて、動的カーソルの -1 または実際の数。
適用対象
関連項目
Filter プロパティと RecordCount プロパティの使用例 (VB)
Filter プロパティと RecordCount プロパティの使用例 (VC++)
AbsolutePosition プロパティ (ADO)
PageCount プロパティ (ADO)