Requery メソッド (ADO)

適用先: Access 2013、Office 2013

オブジェクトの基になるクエリを再実行して、Recordset オブジェクトのデータを更新します。

構文

recordset。再クエリ オプション

パラメーター

名前	説明
Options	省略可能です。 この操作に対する ExecuteOptionEnum 値と CommandTypeEnum 値を含む、ビットマスクを指定します。

注:

オプションが adAsyncExecute に設定されている場合、この操作は非同期的に実行され、終了すると RecordsetChangeComplete イベントが発行されます。

Requery では、ExecuteOpenEnum の値 adExecuteNoRecords または adExecuteStream は使用できません。

注釈

Requery メソッドは、元のコマンドを再実行してデータをもう一度取得することにより、データ ソースで Recordset オブジェクトの内容全体を更新する場合に使用します。 このメソッドの呼び出しは、 Close メソッドと Open メソッドを連続して呼び出すことと同じです。 カレント レコードを編集しているとき、または新規レコードを追加しているときにこのメソッドを呼び出すと、エラーが発生します。

Recordset オブジェクトを開いている間は、カーソルの属性を定義するプロパティ (CursorType、LockType、MaxRecords など) は、読み取り専用になります。 したがって、Requery メソッドでは、現在のカーソルの更新のみを行うことができます。 カーソルのプロパティを変更して結果を確認するには、 Close メソッドを使用して、プロパティを再度読み取り/書き込み可能にする必要があります。 その後、目的のプロパティの設定を変更し、 Open メソッドを呼び出してカーソルを再度開きます。