SqlCommand.ExecuteNonQuery メソッド

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

Public Overridable Function ExecuteNonQuery() As Integer Implements _   IDbCommand.ExecuteNonQuery
[C#]
public virtual int ExecuteNonQuery();
[C++]
public: virtual int ExecuteNonQuery();
[JScript]
public function ExecuteNonQuery() : int;

戻り値

影響を受けた行数。

実装

IDbCommand.ExecuteNonQuery

例外

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

解説

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

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

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

使用例

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

 
Public Sub CreateMySqlCommand(myExecuteQuery As String, myConnection As SqlConnection)
    Dim myCommand As New SqlCommand(myExecuteQuery, myConnection)
    myCommand.Connection.Open()
    myCommand.ExecuteNonQuery()
    myConnection.Close()
End Sub 'CreateMySqlCommand

[C#] 
public void CreateMySqlCommand(string myExecuteQuery, SqlConnection myConnection) 
 {
    SqlCommand myCommand = new SqlCommand(myExecuteQuery, myConnection);
    myCommand.Connection.Open();
    myCommand.ExecuteNonQuery();
    myConnection.Close();
 }

[C++] 
public:
void CreateMySqlCommand(String* myExecuteQuery, SqlConnection* myConnection) 
 {
    SqlCommand* myCommand = new SqlCommand(myExecuteQuery, myConnection);
    myCommand->Connection->Open();
    myCommand->ExecuteNonQuery();
    myConnection->Close();
 }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

SqlCommand クラス | SqlCommand メンバ | System.Data.SqlClient 名前空間