Execute

(PWS4 IIS4 IIS5)
Execute — 指定されたクエリ、SQL ステートメント、ストアド プロシージャ、またはプロバイダ固有のテキストを実行します。

戻り値

Recordset オブジェクトへの参照を返します。

パラメータ

CommandText 実行する SQL ステートメント、テーブル名、ストアド プロシージャ、URL、またはプロバイダ固有のテキストを含む文字列型 (String) の値を指定します。
RecordsAffected 省略可能です。長整数型 (Long) の変数を指定します。プロバイダは、この操作の影響を受けたレコード数をここに返します。
Options 省略可能です。プロバイダが CommandText 引数を評価する方法を示す長整数型 (Long) の値を指定します。1 つまたは複数の CommandTypeEnum 値または ExecuteOptionEnum 値のビットマスクを指定できます。

説明

Connection オブジェクトで Execute メソッドを使用すると、指定した接続上で、CommandText 引数に指定したクエリが実行されます。CommandText 引数に、行を返すクエリが指定されている場合、クエリの実行結果はすべて新規 Recordset オブジェクトに保存されます。行を返すクエリ以外のコマンドの場合は、プロバイダは閉じた Recordset オブジェクトを返します。

返された Recordset オブジェクトは常に読み取り専用で、前方スクロールタイプのカーソルです。Recordset オブジェクトに、より多くの機能が必要な場合は、まず、目的のプロパティ設定を持つ Recordset オブジェクトを作成し、次に、Recordset オブジェクトの Open メソッドを使ってクエリを実行して目的のカーソルの種類を返します。

CommandText 引数の内容はプロバイダに固有のものであり、標準の SQL 構文、またはプロバイダがサポートする固有のコマンド形式を使用できます。

この操作が完了すると ExecuteComplete イベントが発生します。