CRecordset::GetRecordCount

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

レコードセットのサイズを調べます。

long GetRecordCount( ) const;

戻り値

レコードセットのレコード数を返します。レコードセットがレコードを持っていない場合は 0 を返します。レコードの数がわからない場合は -1 を返します。

解説

注意 :
レコード数は "最高水位線" のように管理されます。つまり、それまで移動した中での最大レコード番号がその時点でのレコード数になります。レコードの合計数は、ユーザーが最終レコードを越えて移動して初めてわかります。性能上の理由から、MoveLast 関数を呼び出してもレコード数は更新されません。ユーザーが独自にレコード数を数えるには、IsEOF が 0 以外を返すまで MoveNext を繰り返し呼び出します。CRecordset:AddNew 関数や Update 関数を使ってレコードを追加すると、カウントは増加します。CRecordset::Delete 関数を使ってレコードを削除すると、カウントは減少します。

レコード数は "最高水位線" のように管理されます。つまり、それまで移動した中での最大レコード番号がその時点でのレコード数になります。レコードの合計数は、ユーザーが最終レコードを越えて移動して初めてわかります。性能上の理由から、MoveLast 関数を呼び出してもレコード数は更新されません。ユーザーが独自にレコード数を数えるには、IsEOF が 0 以外を返すまで MoveNext を繰り返し呼び出します。CRecordset:AddNew 関数や Update 関数を使ってレコードを追加すると、カウントは増加します。CRecordset::Delete 関数を使ってレコードを削除すると、カウントは減少します。