SqlCommand.ExecuteNonQuery メソッド

.NET Framework クラス ライブラリ リファレンス

SqlCommand.ExecuteNonQuery メソッド

接続に対して Transact-SQL ステートメントを実行し、影響を受けた行数を返します。

名前空間: System.Data.SqlClient
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Overrides Function
 ExecuteNonQuery As Integer

Visual Basic (使用法)

Dim instance As SqlCommand
Dim returnValue As Integer

returnValue = instance.ExecuteNonQuery

C#

public override int ExecuteNonQuery ()

C++

public:
virtual int ExecuteNonQuery () override

J#

public int ExecuteNonQuery ()

JScript

public override function ExecuteNonQuery ()
 : int

戻り値
影響を受けた行数。

例外

例外の種類	条件
SqlException	ロックされている行に対してコマンドを実行しているときに例外が発生しました。この例外は .NET Framework Version 1.0 を使用している場合は生成されません。

解説

ExecuteNonQuery では、カタログ操作 (データベース構造の照会、テーブルなどのデータベース オブジェクトの作成など) を実行できます。また、DataSet を使用せずに、UPDATE、INSERT、または DELETE ステートメントを実行して、データベース内のデータを変更することもできます。

ExecuteNonQuery は行を返しませんが、出力パラメータ、またはパラメータに割り当てられた戻り値には、データが格納されます。

UPDATE、INSERT、および DELETE ステートメントでの戻り値は、そのコマンドの影響を受ける行数です。他の種類のステートメントでの戻り値は、-1 です。ロールバックが発生した場合も、戻り値は -1 です。

使用例

SqlCommand を作成し、ExecuteNonQuery を使用して実行する例を次に示します。この例では、Transact-SQL ステートメント (UPDATE、INSERT、DELETE など) の文字列とデータ ソースへの接続に使用する文字列が渡されます。

Visual Basic

Public Sub CreateCommand(ByVal
 queryString As String, _
  ByVal connectionString As String)
    Using connection As New SqlConnection(connectionString)
        Dim command As New
 SqlCommand(queryString, connection)
        command.Connection.Open()
        command.ExecuteNonQuery()
    End Using
End Sub

C#

private static void CreateCommand(string
 queryString,
    string connectionString)
{
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        SqlCommand command = new SqlCommand(queryString, connection);
        command.Connection.Open();
        command.ExecuteNonQuery();
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
SqlCommand クラス
SqlCommand メンバ
System.Data.SqlClient 名前空間
その他の技術情報
ADO.NET でのデータへの接続およびデータの取得
.NET Framework Data Provider for SQL Server の使用