CDaoRecordset::GetAbsolutePosition

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

更新 : 2007 年 11 月

レコードセットオブジェクトの現在のレコードのレコード番号を返します。

long GetAbsolutePosition( );

戻り値

0 から、レコードセットのレコード数までの整数を返します。レコードセット内での現在のレコードの位置。

解説

基になる DAO オブジェクトの AbsolutePosition プロパティの値は、0 から始まります。0 はレコードセット内の先頭レコードを指します。GetRecordCount の呼び出しにより、レコードセットに集められたレコード数を調べることができます。GetRecordCount は、カウントを調べるためにすべてのレコードにアクセスするため、少し時間がかかります。

レコードセットにレコードがないときなど、現在のレコードがない場合は、-1 が返されます。現在のレコードが削除されると、AbsolutePosition プロパティは定義されず、このプロパティが参照されると MFC は例外をスローします。ダイナセットタイプのレコードセットでは、新しいレコードは、シーケンスの最後に追加されます。

メモ :
このプロパティは、レコード番号の代わりに使用するものではありません。指定した位置を記憶し、返すために推奨できる方法はブックマークです。ブックマークは、すべての型のレコードセットオブジェクトで、現在のレコードを位置付けできる唯一の方法です。特に、指定されたレコードの位置は、前のレコードが削除されると変化します。レコードセット内のレコードの順番は、ORDER BY 句を使用した SQL ステートメントで作成されない限り保証されないため、レコードセットが再作成された場合に、特定のレコードが同じ絶対位置を持つことも保証されません。

このプロパティは、レコード番号の代わりに使用するものではありません。指定した位置を記憶し、返すために推奨できる方法はブックマークです。ブックマークは、すべての型のレコードセットオブジェクトで、現在のレコードを位置付けできる唯一の方法です。特に、指定されたレコードの位置は、前のレコードが削除されると変化します。レコードセット内のレコードの順番は、ORDER BY 句を使用した SQL ステートメントで作成されない限り保証されないため、レコードセットが再作成された場合に、特定のレコードが同じ絶対位置を持つことも保証されません。

メモ :
このメンバ関数は、ダイナセットタイプのレコードセットとスナップショットタイプのレコードセットに対してだけ有効です。

関連情報については、DAO ヘルプの「AbsolutePosition Property」を参照してください。