CDaoRecordset::GetRecordCount
レコードセットのレコードの数がアクセスする前にこのメンバー関数を呼び出します。
long GetRecordCount( );
戻り値
レコードセット オブジェクトにアクセスするレコード数を返します。
解説
GetRecordCount はすべてのレコードがアクセスされるまで、レコード型がダイナセットとスナップショット タイプのレコードセットに含まれているかを示します。このメンバー関数呼び出しが完了する時間がかかることがあります。
一度最後のレコードは、戻り値示しますレコードセットのレコードの総数保持にアクセスします。最後のレコードにアクセスするように強制するには、レコードセットの MoveLast または FindLast のメンバー関数を呼び出します。また、クエリが返すおおよそのレコード数を決定するために SQL の計算を使用できます。
アプリケーションがダイナセット型のレコードセットのレコードを削除するため、GetRecordCount の戻り値が低下します。ただし、他のユーザーが削除したレコードに GetRecordCount すると、現在のレコードが削除したレコードに設定されるまで反映されません。レコード カウントと影響を与える従ってトランザクションをロールバックするトランザクションを実行すると、GetRecordCount は、残りのレコードの実際の数は反映されません。
スナップショット タイプのレコードセットの GetRecordCount の値は、基になるテーブルの変更による影響はありません。
テーブル タイプのレコードセットから GetRecordCount の値は、テーブル内のレコードが追加されたり削除されたりするには、テーブルのおおよそのレコード数を表し、反映されます。
レコードのないレコードセットは、0 の値を返します。アタッチ テーブルまたは ODBC データベースを使用する場合、GetRecordCount は– 1.を常に返します。レコードセットの [再クエリ] のメンバー関数を呼び出すと、クエリが再実行された GetRecordCount の値をリセットします。
関連情報は、DAO ヘルプ トピック「RecordCount プロパティ」を参照してください。
必要条件
Header: afxdao.h