Requery メソッド

  • [アーティクル]

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

構文

  
recordset.Requery Options

パラメーター

[オプション]
省略可能。 この操作に影響を与える ExecuteOptionEnum と CommandTypeEnum の値が含まれるビットマスク。

注意

"Options" が adAsyncExecute に設定されると、この操作は非同期的に実行され、終了したときに RecordsetChangeComplete イベントが発行されます。 Requery では、adExecuteNoRecords または adExecuteStream の ExecuteOpenEnum 値を使用しないでください。

注釈

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

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

適用対象

Recordset オブジェクト (ADO)

参照

Execute、Requery、および Clear メソッドの例 (VB)
Execute、Requery、および Clear メソッドの例 (VBScript)
Execute、Requery、および Clear メソッドの例 (VC++)
CommandText プロパティ (ADO)