CRecordset::MoveFirst

更新 : 2007 年 11 月

現在のレコードを先頭行セットの先頭レコードに位置付けます。

void MoveFirst( );

解説

バルク行フェッチが実装されているかどうかに関係なく、レコードセットの先頭レコードに移動します。

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

メモ :
このメンバ関数は、前方参照だけのレコードセットでは無効です。

メモ :
レコードセット内を移動するときに、削除したレコードをスキップすることはできません。詳細については、IsDeleted メンバ関数を参照してください。

注意 :
レコードセットにレコードが存在しない場合は、Move 関数のいずれかを呼び出すと例外がスローされます。レコードセットにレコードが存在するかどうかを調べるには、IsBOF と IsEOF を呼び出します。

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

レコードセットの移動の詳細については、「レコードセット : ブックマークと絶対位置 (ODBC)」と「レコードセット : スクロール (ODBC)」を参照してください。バルク行フェッチの詳細については、「レコードセット : バルク行フェッチ (ODBC)」を参照してください。