CDaoRecordset::Requery
レコードセットをリビルド (再表示) します。
virtual void Requery( );
解説
複数のレコードが返されたときは、先頭のレコードが現在のレコードになります。
ユーザー自身またはほかのユーザーがデータ ソースに行った追加や削除をレコードセットに反映させるには、Requery 関数を呼び出してレコードセットを再度ビルドします。 レコードセットがダイナセットの場合、ユーザー自身またはほかのユーザーが行った既存のレコードへの更新 (追加は除きます) は自動的に反映されます。 レコードセットがスナップ ショットの場合は、ほかのユーザーによる追加、削除、編集を反映するには、Requery を呼び出す必要があります。
ダイナセット タイプまたはスナップショット タイプで、パタメータ値を使用してレコードセットをリビルドするには、Requery を呼び出します。 Requery を呼び出す前に、m_strFilter および m_strSort を設定して、新しいフィルターや並べ替えを設定します。 Requery を呼び出す前に、パラメーター データ メンバーに新しい値を代入して、新しいパラメーターを設定します。
レコードセットのリビルドに失敗すると、レコードセットは閉じます。 Requery を呼び出す前に CanRestart メンバー関数を呼び出して、レコードセットが再クエリできるかどうかを調べることができます。 CanRestart は Requery の成功を保証しません。
ヒント
Open を呼び出した後に限り、Requery を呼び出してください。
注意
Requery を呼び出すと、DAO ブックマークが変更されます。
CanRestart の呼び出しが 0 を返すと、ダイナセット タイプのレコードセット、またはスナップショット タイプのレコードセットでは Requery を呼び出すことはできません。また、テーブル タイプのレコードセットでは Requery を使用できません。
Requery の呼び出し後、IsBOF と IsEOF の両方が 0 以外を返すと、クエリはレコードを返していなく、レコードセットにはデータがないことを示します。
関連情報については、DAO ヘルプの「Requery Method」を参照してください。
必要条件
**ヘッダー:**afxdao.h