Execute

(PWS4 IIS4 IIS5)
Execute — CommandText プロパティまたは CommandStream プロパティで指定されたクエリ、SQL ステートメント、またはストアド プロシージャを実行します。

戻り値

Recordset オブジェクトへの参照、ストリーム、または Nothing を返します。

説明

Command オブジェクトで Execute メソッドを使用すると、オブジェクトの CommandText プロパティまたは CommandStream プロパティで指定したクエリが実行されます。

結果は Recordset に返される (既定) か、バイナリ情報のストリームとして返されます。バイナリストリームを取得するには、Options に adExecuteStream を指定し、Command.Properties(“Output Stream”) を設定してストリームを与えます。結果を受け取るには、ADO Stream オブジェクト、または IIS Response オブジェクトなどの別のストリーム オブジェクトを指定することができます。adExecuteStream が指定されている Execute を呼び出す前にストリームが指定されなかった場合は、エラーが発生します。Execute から値が返されるときのストリームの位置は、プロバイダによって決まっています。

結果を返すことが目的ではないコマンド (SQL UPDATE クエリなど) では、プロバイダは Nothing を返します。いくつかのアプリケーション言語では、Recordset が必要とされない場合に、この戻り値を無視できます。

Execute では、CommandType が adCmdStoredProc、adCmdTable、または adCmdTableDirect のときに CommandStream に値を指定すると、エラーが発生します。

クエリにパラメータが存在する場合、Execute メソッドの呼び出し時にパラメータ値を渡して置き換えない限り、Command オブジェクトの現在のパラメータ値が使用されます。Execute メソッドを呼び出す際に、パラメータのいくつかの新しい値を省略して、パラメータのサブセットを上書きすることができます。パラメータを指定する順番は、メソッドで渡される順番と同じです。たとえば、4 つまたはそれ以上のパラメータがあり、1 番目と 4 番目のパラメータのみに新しい値を渡すには、Parameters 引数に、Array(var1,,,var4) のように指定します。