CDaoRecordset::SetAbsolutePosition

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

更新 : 2007 年 11 月

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

void SetAbsolutePosition(
   long lPosition 
);

パラメータ

lPosition
レコードセット内での現在のレコードの位置。

解説

SetAbsolutePosition を呼び出すことにより、ダイナセットタイプのレコードセット、またはスナップショットタイプのレコードセットの位置を基準にして、特定のレコードに現在のレコードポインタを位置付けることができます。GetAbsolutePosition を呼び出して現在のレコード番号を調べることもできます。

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

基になる DAO オブジェクトの AbsolutePosition プロパティの値は、0 から始まります。0 はレコードセット内の先頭レコードを指します。集められたレコードの数を超えた値を設定すると、MFC は例外をスローします。GetRecordCount メンバ関数を呼び出して、レコードセットに集められたレコード数を調べることができます。

現在のレコードが削除されると、AbsolutePosition プロパティは定義されず、このプロパティが参照されると MFC は例外をスローします。新しいレコードは、シーケンスの末尾に追加されます。

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

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

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