OleDbCommand.ExecuteNonQuery Method

Definition

Namespace:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Package:

System.Data.OleDb v10.0.0-preview.1.25080.5

Source:

OleDbCommand.cs

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

C#

public override int ExecuteNonQuery();

Returns

Int32

The number of rows affected.

Implements

ExecuteNonQuery()

Exceptions

InvalidOperationException

The connection does not exist.

-or-

The connection is not open.

-or-

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

Examples

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.

C#

static private void CreateOleDbCommand(
    string queryString, string connectionString)
{
    using (OleDbConnection connection = new
               OleDbConnection(connectionString))
    {
        connection.Open();
        OleDbCommand command = new
            OleDbCommand(queryString, connection);
        command.ExecuteNonQuery();
    }
}

Remarks

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.

Applies to

See also

• Working with Commands