Execute メソッド (ADO Command)

  • [アーティクル]

適用先: Access 2013 | Access 2016

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

構文

Recordset を返す Command の場合の構文は次のとおりです。

For a non-recordset-returning Command:

戻り値

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

パラメーター

  • RecordsAffected

    • 省略可能です。 この操作の影響を受けたレコード数をプロバイダーが返す長整数型 ( Long ) の値です。 RecordsAffected パラメーターは、アクション クエリまたはストアド プロシージャにのみ適用されます。 RecordsAffected は、結果を返すクエリまたはストアド プロシージャによって返されるレコードの数を返しません。 この情報を取得するには、 RecordCount プロパティを使用します。 コマンドを非同期的に実行すると、影響を受けるレコードの数がメソッドから返された時点でまだわかっていない可能性があるため、 Execute メソッドは adAsyncExecute で使用した場合、正しい情報を返しません。

  • Parameters

    • 省略可能です。 SQL ステートメントに渡すパラメーター値のバリアント型 ( Variant ) 配列です。 出力パラメーターをこの引数で渡しても、正しい値は返されません。

  • Options

    • オプション。 Command オブジェクトの CommandText プロパティをプロバイダーが評価する方法を示す長整数型 (Long) の値です。 CommandTypeEnum 値および ExecuteOptionEnum 値のビットマスク値を使用できます。 たとえば、CommandText プロパティの値をテキストとして評価するよう ADO に指示し、コマンド テキストの実行時に生成されるすべてのレコードをコマンドが破棄して返さないようにする場合は、adCmdText と adExecuteNoRecords を組み合わせて使用できます。

注釈

Command オブジェクトに対して Execute メソッドを使用すると、オブジェクトの CommandText プロパティで指定されているクエリが実行されます。 行を返すクエリが CommandText プロパティで指定されていると、実行が生成するすべての結果は、新しい Recordset オブジェクトに格納されます。 コマンドが行を返さないクエリである場合、プロバイダーは閉じた Recordset オブジェクトを返します。 アプリケーション言語によっては、 Recordset が必要ないときはこの戻り値を無視してもかまいません。

If the query has parameters, the current values for the Command object's parameters are used unless you override these with parameter values passed with the Execute call. You can override a subset of the parameters by omitting new values for some of the parameters when calling the Execute method. The order in which you specify the parameters is the same order in which the method passes them. たとえば、4 つ以上のパラメーターがあり、最初と 4 番目のパラメーターに対してのみ新しい値を渡す場合は、 Parameters 引数としてを渡します。

注:

出力パラメーターを Parameters 引数で渡しても、正しい値は返されません。

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

関連項目

サポートとフィードバック

Office VBA またはこの説明書に関するご質問やフィードバックがありますか？ サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。