ExecuteNonQuery Method

OleDbCommand.ExecuteNonQuery Method ()


Executes an SQL statement against the Connection and returns the number of rows affected.

Namespace:   System.Data.OleDb
Assembly:  System.Data (in System.Data.dll)

public override int ExecuteNonQuery()

Return Value

Type: System.Int32

The number of rows affected.

Exception Condition

The connection does not exist.


The connection is not open.


Cannot execute a command within a transaction context that differs from the context in which the connection was originally enlisted.

You can use the ExecuteNonQuery to perform catalog operations, for example, to query the structure of a database or to create database objects such as tables, or to change the data in a database without using a DataSet by executing UPDATE, INSERT, or DELETE statements.

Although the ExecuteNonQuery returns no rows, any output parameters or return values mapped to parameters are populated with data.

For UPDATE, INSERT, and DELETE statements, the return value is the number of rows affected by the command. For all other types of statements, the return value is -1. If a rollback occurs, the return value is also -1.

The following example creates an OleDbCommand and then executes it using ExecuteNonQuery. The example is passed a string that is an SQL statement such as UPDATE, INSERT, or DELETE, and a string to use to connect to the data source.

static private void CreateOleDbCommand(
    string queryString, string connectionString)
    using (OleDbConnection connection = new 
        OleDbCommand command = new 
            OleDbCommand(queryString, connection);

.NET Framework
Available since 1.1
Return to top
© 2015 Microsoft