ServerConnection.ExecuteNonQuery Method (String)

  • [アーティクル]

結果セットを返さないステートメントを実行します。

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

構文

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

public int ExecuteNonQuery (
    string sqlCommand
)

public:
int ExecuteNonQuery (
    String^ sqlCommand
)

public int ExecuteNonQuery (
    String sqlCommand
)

public function ExecuteNonQuery (
    sqlCommand : String
) : int

パラメータ

  • sqlCommand
    実行する Transact-SQL コマンドを指定する String 値です。

戻り値

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

解説

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

ExecuteNonQuery メソッドによって認識されるのは SQLCMD コマンドのみです。sqlCommand パラメータに SQLCMD コマンド以外のステートメントが格納されている場合、メソッドは失敗し、ExecutionFailureException 例外が発生します。

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

使用例

'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server
'Set the execution mode to CaptureSql for the connection.
srv.ConnectionContext.SqlExecutionModes = SqlExecutionModes.CaptureSql
'Make a modification to the server that is to be captured.
srv.UserOptions.AnsiNulls = True
srv.Alter()
'Iterate through the strings in the capture buffer and display the captured statements.
Dim s As String
For Each s In srv.ConnectionContext.CapturedSql.Text
    Console.WriteLine(s)
Next
'Execute the captured statements.
srv.ConnectionContext.ExecuteNonQuery(srv.ConnectionContext.CapturedSql.Text)
'Revert to immediate execution mode. 
srv.ConnectionContext.SqlExecutionModes = SqlExecutionModes.ExecuteSql

スレッド セーフ

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

プラットフォーム

開発プラットフォーム

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

対象プラットフォーム

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

参照

関連項目

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

その他の技術情報

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