ExcelWork.info

Recordset オブジェクト内のレコード数(ADO)RecordCount プロパティ

RecordCount プロパティ

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


【書式】

<取得>
long = object.RecordCount


引数・戻り値

  • object  ・・・  対象となる Recordset オブジェクトを指定します。
  • long  ・・・  Recordset のレコード数を示す長整数型(long)の値を取得します。ただし、レコード数がわからない場合、プロバイダやカーソルタイプが RecordCount をサポートしていない場合は、-1 を返します。

閉じている Recordset 上で RecordCount プロパティ を取得するとエラーが発生します。

Recordset オブジェクトのカーソルタイプ別の RecordCount プロパティ の戻り値

【書式】 object.CursorType = <カーソルタイプ>

※ object … Recordset オブジェクト

カーソルタイプ 内容 戻り値
adOpenDynamic 動的カーソル -1
adOpenForwardOnly 前方スクロールカーソル -1
adOpenKeyset キーセットカーソル レコード数
adOpenStatic 静的カーソル レコード数

CursorLocation プロパティadUseClient を設定した場合は、すべてのカーソルタイプで、レコード数が戻り値となります。

【書式】 object.CursorLocation = <カーソルロケーション>

※ object … Recordset オブジェクト

カーソルロケーション 内容
adUseNone 1 カーソル サービスを使いません
adUseServer 2 サーバーサイドカーソル(既定値)
adUseClient 3 クライアントサイドカーソル



RecordCount プロパティ 使用例

サンプルVBAソース


実行結果