Executes a Transact-SQL statement against the connection and returns the number of rows affected.

[Visual Basic]
Shared  OverloadsPublic Function ExecuteNonQuery( _ 
   ByVal connection As SqlConnection, _ 
   ByVal database As String, _ 
   ByVal commandText As String, _ 
   ByVal ParamArray parameters As SqlParameter() _ 
) As Integer
[C#]
public static int ExecuteNonQuery(
   SqlConnection connection,
   string database,
   string commandText,
   params SqlParameter[] parameters
);
[C++]
public: static int ExecuteNonQuery(
   SqlConnection* connection,
   String* database,
   String* commandText,
   SqlParameter* parameters __gc[]
);
[JScript]
public static function ExecuteNonQuery(
   SqlConnection connection,
   String database,
   String commandText,
   SqlParameter[] parameters
): int;

Parameters

connection

Represents an open connection to a SQL Server database.

database

Changes the current database for an open System.Data.SqlClient.SqlConnection.

commandText

The text of the query.

parameters

A list of type System.Data.SqlClient.SqlParameter that maps to the System.Data.SqlClient.SqlCommand.

Return Value

The number of rows affected.

Example

[C#, Visual Basic] The following example creates a SqlCommand and then executes it using ExecuteNonQuery. The example is passed a string that is a Transact-SQL statement (such as UPDATE, INSERT, or DELETE) and a string to use to connect to the data source.

[C#]
SqlConnection connection = new SqlConnection("Server=127.0.0.1;Database=Northwind;Uid=sa;Pwd=;");

DatabaseUtility.ExecuteNonQuery(
    connection,
    "Northwind",
    "INSERT INTO Categories (CategoryName) VALUES (@CategoryName)",
    new SqlParameter("@CategoryName", "New Category")
);
[Visual Basic]
Dim connection As New SqlConnection("Server=127.0.0.1;Database=Northwind;Uid=sa;Pwd=;")

DatabaseUtility.ExecuteNonQuery( _
    connection, _
    "Northwind", _
    "INSERT INTO Categories (CategoryName) VALUES (@CategoryName)", _
    New SqlParameter("@CategoryName", "New Category")
)

            

See Also

DatabaseUtility Class | Joel.Net Namespace | DatabaseUtility.ExecuteNonQuery Overload List