RecordCount プロパティ

Recordset オブジェクトの現在のレコード数を示します。

戻り値

長整数型 (Long) の値を返します。

解説

RecordCount プロパティは、Recordset オブジェクトにあるレコードの数を調べるために使います。ADO がレコードの数を特定できないときは、このプロパティは adUnknown (-1) を返します。閉じている RecordsetRecordCount プロパティを読み取ろうとするとエラーになります。

Recordset オブジェクトが近似位置指定やブックマークの機能をサポートしている場合、Recordset が完全に再収集されているかどうかにかかわらず、この値は常に Recordset 内の正確なレコード数になります。Recordset オブジェクトが近似位置指定の機能をサポートしていない場合には、このプロパティを参照したときにリソースを著しく消費することがあります。これは、RecordCount の正確な値を返すためにすべてのレコードを取得してその数を数える必要があるためです。

対象

Recordset

関連項目

AbsolutePositionPageCount