RecordCount プロパティ (ADO)

適用先: Access 2013、Office 2013

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

戻り値

Recordset のレコード数を示す長整数型 (Long) の値を返します。

注釈

Recordset オブジェクトに存在するレコード数を調べるには、 RecordCount プロパティを使用します。 ADO でレコード数を特定できない場合や、プロバイダーやカーソルのタイプが RecordCount をサポートしていない場合、このプロパティは -1 を返します。 閉じている Recordset オブジェクトの RecordCount プロパティを取得しようとすると、エラーが発生します。

Recordset オブジェクトがおよその位置付けまたはブックマークをサポートしている場合、つまり、 Supports (adApproxPosition) または Supports (adBookmark) がそれぞれ True を返す場合、 Recordset の値がすべて設定されているかどうかに関係なく、正確なレコード数が返されます。 Recordset オブジェクトがおよその位置付けをサポートしていない場合、正確な RecordCount の値を返すにはすべてのレコードを取得してカウントする必要があるので、このプロパティが大量のリソースを消費する可能性があります。

Recordset オブジェクトのカーソルの種類は、レコードの数を決定できるかどうかに影響します。 RecordCount プロパティは、前方専用カーソルの場合は -1 を返します。静的カーソルまたはキーセット カーソルの実際のカウント。データ ソースに応じて、-1 または動的カーソルの実際のカウント。