OleDbCommand.ExecuteNonQuery Метод

Определение

Выполняет оператор SQL применительно к свойству Connection и возвращает количество измененных командой строк.Executes an SQL statement against the Connection and returns the number of rows affected.

public:
 virtual int ExecuteNonQuery();
public int ExecuteNonQuery ();
override this.ExecuteNonQuery : unit -> int
Public Function ExecuteNonQuery () As Integer

Возвраты

Число обработанных строк.The number of rows affected.

Реализации

Исключения

Подключение не существует.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.

Примеры

В следующем примере создается OleDbCommand, а затем выполняется с помощью ExecuteNonQuery.The following example creates an OleDbCommand and then executes it using ExecuteNonQuery. В примере передается строка, которая является инструкцией SQL, такой как UPDATE, INSERT или DELETE, и строка, используемая для подключения к источнику данных.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 
               OleDbConnection(connectionString))
    {
        connection.Open();
        OleDbCommand command = new 
            OleDbCommand(queryString, connection);
        command.ExecuteNonQuery();
    }
}
Private Sub CreateOleDbCommand( _
    ByVal queryString As String, ByVal connectionString As String)
    Using connection As New OleDbConnection(connectionString)
        connection.Open()
        Dim command As New OleDbCommand(queryString, connection)
        command.ExecuteNonQuery()
    End Using
End Sub

Комментарии

ExecuteNonQuery можно использовать для выполнения операций с каталогом, например для запроса структуры базы данных или создания объектов базы данных, таких как таблицы, или для изменения данных в базе данных без использования DataSet путем выполнения инструкции UPDATE, INSERT или инструкции DELETE.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.

Хотя ExecuteNonQuery не возвращает ни одной строки, все выходные параметры или возвращаемые значения, сопоставленные с параметрами, заполняются данными.Although the ExecuteNonQuery returns no rows, any output parameters or return values mapped to parameters are populated with data.

Операторы UPDATE, INSERT и DELETE возвращают количество строк, которые были обработаны с их помощью.For UPDATE, INSERT, and DELETE statements, the return value is the number of rows affected by the command. Для всех прочих типов операторов возвращаемым значением является -1.For all other types of statements, the return value is -1. Если происходит откат, возвращаемое значение также равно-1.If a rollback occurs, the return value is also -1.

Применяется к

Дополнительно