ServerConnection.ExecuteNonQuery Method (String, ExecutionTypes)

  • [アーティクル]

指定された実行オプションで、結果セットを返さないステートメントを実行します。

名前空間: Microsoft.SqlServer.Management.Common
アセンブリ: Microsoft.SqlServer.ConnectionInfo (microsoft.sqlserver.connectioninfo.dll 内)

構文

'宣言
Public Function ExecuteNonQuery ( _
    sqlCommand As String, _
    executionType As ExecutionTypes _
) As Integer

public int ExecuteNonQuery (
    string sqlCommand,
    ExecutionTypes executionType
)

public:
int ExecuteNonQuery (
    String^ sqlCommand, 
    ExecutionTypes executionType
)

public int ExecuteNonQuery (
    String sqlCommand, 
    ExecutionTypes executionType
)

public function ExecuteNonQuery (
    sqlCommand : String, 
    executionType : ExecutionTypes
) : int

パラメータ

  • sqlCommand
    実行する Transact-SQL コマンドを指定する String 値です。
  • executionType
    Transact-SQL ステートメントの実行オプションを示す ExecutionTypes オブジェクト値です。

戻り値

UPDATE ステートメント、INSERT ステートメント、および DELETE ステートメントに対応する Transact-SQL コマンドの影響を受ける行の合計数を示す Int32 値です。他のすべての種類のステートメントでは、戻り値は -1 です。

解説

Transact-SQL コマンドは、サーバーの設定に影響を与えるデータ定義言語 (DDL) ステートメントまたはストアド プロシージャであることが普通です。CapturedSql オブジェクトの Text プロパティは、キャプチャされた Transact-SQL ステートメントの実行を許可するための sqlCommand パラメータとして使用できます。sqlCommand パラメータは、単一の Transact-SQL ステートメントを格納します。

ExecuteNonQuery メソッドによって認識されるのは SQLCMD コマンドのみです。sqlCommand パラメータに SQLCMD コマンド以外のステートメントが格納されている場合、ExecutionTypes.ContinueOnError 値を含めるように executionType パラメータが設定されていない限り、メソッドは失敗し、ExecutionFailureException 例外が発生します。

この名前空間、クラス、またはメンバは、Microsoft .NET Framework Version 2.0 でのみサポートされています。

スレッド セーフ

この型の public static (Microsoft Visual Basic では共有 ) メンバは、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

開発プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

対象プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

参照

関連項目

ServerConnection Class
ServerConnection Members
Microsoft.SqlServer.Management.Common Namespace

その他の技術情報

Visual Basic .NET でキャプチャ モードを有効にする方法
キャプチャ モードの使用