CDaoRecordset::Requery
更新 : 2007 年 11 月
レコードセットをリビルド (再表示) します。
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