Execute メソッド (ADO Connection)

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

構文

  
Set recordset = connection.Execute (CommandText, RecordsAffected, Options)  
Set recordset = connection.Execute (CommandText, RecordsAffected, Options)  

戻り値

Recordset オブジェクト (ADO) オブジェクト参照を返します。

パラメーター

CommandText
実行する SQL ステートメント、ストアド プロシージャ、URL、またはプロバイダー固有のテキストを含む文字列値。 必要に応じて、プロバイダーが SQL 対応の場合にのみ、テーブル名を使用できます。 たとえば、"Customers" のテーブル名が使用されている場合、ADO は自動的に標準の SQL Select 構文の前に作成し、Transact-SQL ステートメントとして "SELECT * FROM Customers" をプロバイダーに渡します。

RecordsAffected
省略可能。 プロバイダーが操作の影響を受けたレコードの数を返す Long 変数。

[オプション]
省略可能。 プロバイダーで CommandText を評価する方法を示す Long 値。 1 つ以上の CommandTypeEnum または ExecuteOptionEnum 値のビットマスクを指定できます。

注ExecuteOptionEnum 値 adExecuteNoRecords を使用して、内部処理を最小限に抑え、Visual Basic 6.0 から移植するアプリケーションのパフォーマンスを向上させます。

Connection オブジェクトの Execute メソッドで adExecuteStream を使用しないでください。

adCmdFile または adCmdTableDirect の CommandTypeEnum 値を Execute で使用しないでください。 これらの値は、レコードセットの Open メソッド (ADO Recordset) と Requery メソッドで、オプションとしてのみ使用できます。

注釈

Connection オブジェクト (ADO) で Execute メソッドを使用すると、指定した接続の CommandText 引数でメソッドに渡すクエリが実行されます。 CommandText 引数が行を返すクエリを指定する場合、実行によって生成されるすべての結果は、新しい Recordset オブジェクトに格納されます。 コマンドが結果を返すことを意図していない場合 (SQL UPDATE クエリなど)、adExecuteNoRecords オプションが指定されている限り、プロバイダーから Nothing が返されます。それ以外の場合、Execute は閉じたレコードセットを返します。

返される Recordset オブジェクトは、常に読み取り専用の順方向専用カーソルです。 より多くの機能を備えた Recordset オブジェクトが必要な場合は、まず目的のプロパティ設定で Recordset オブジェクトを作成してから、Recordset オブジェクトの Open メソッド (ADO Recordset) を使用してクエリを実行し、目的のカーソルの種類を返します。

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

この操作が完了すると、ExecuteComplete イベントが発行されます。

注意

http スキームを使用する URL は、Microsoft OLE DB Provider for Internet Publishing を自動的に呼び出します。 詳細については、「絶対 URL と相対 URL」を参照してください。

適用対象

Connection オブジェクト (ADO)