CDaoRecordset::MoveFirst

更新 : 2007 年 11 月

レコードセットの先頭のレコードがある場合、そのレコードを現在のレコードにします。

void MoveFirst( );

解説

レコードセットを開いた直後は、MoveFirst を呼び出す必要はありません。この場合は、先頭のレコードが自動的に現在のレコードになります。

注意 :
レコードセットにレコードが存在しない場合は、Move 関数のいずれかを呼び出すと例外がスローされます。通常、移動操作の前に IsBOF と IsEOF の両方を呼び出して、レコードセットにレコードあるかどうかを確認します。Open または Requery を呼び出した後、IsBOF または IsEOF のどちらかを呼び出します。

メモ :
現在のレコードを更新または追加しているときに、現在のレコードセットを移動する関数を呼び出すと、警告なしに更新が破棄されます。

条件を指定しないでレコード間を移動するには、Move 関数を使います。ダイナセット、またはスナップショット タイプのレコードセットで条件に一致するレコードを見つけるには、検索操作を呼び出します。テーブル タイプのレコードセット オブジェクトでは、Seek を呼び出します。

レコードセットがテーブル タイプのレコードセットを参照しているときの移動は、テーブルの現在のインデックスに従います。基になる DAO オブジェクトの Index プロパティを使って、現在のインデックスを設定できます。現在のインデックスを設定しないと、返されるレコードの順番は不定になります。

SQL クエリまたはクエリ定義を基にしたレコードセット オブジェクトの MoveLast を呼び出すと、クエリは強制的に完了させられ、レコードセット オブジェクトにすべてが集められます。

前方スクロール専用のスナップショットでは、MoveFirst メンバ関数または MovePrev メンバ関数を呼び出すことはできません。

レコードセット オブジェクトの現在のレコードの位置を指定したレコード数分、前方、または後方へ移動するには、Move を呼び出します。

関連情報については、DAO ヘルプの「Move Method」と「MoveFirst, MoveLast, MoveNext, MovePrevious Methods」を参照してください。

必要条件

ヘッダー : afxdao.h

参照

参照

CDaoRecordset クラス

階層図

CDaoRecordset::Move

CDaoRecordset::MoveLast

CDaoRecordset::MoveNext

CDaoRecordset::MovePrev

その他の技術情報

CDaoRecordset のメンバ