IDbCommand.ExecuteNonQuery Метод

Определение

Пространство имен:

System.Data

Сборка:

System.Data.Common.dll

Выполняет инструкцию SQL для объекта Connection поставщика данных .NET и возвращает число задействованных строк.

public:
 int ExecuteNonQuery();

public int ExecuteNonQuery ();

abstract member ExecuteNonQuery : unit -> int

Public Function ExecuteNonQuery () As Integer

Возвращаемое значение

Int32

Число обработанных строк.

Исключения

InvalidOperationException

Подключение не существует.

-или-

Соединение не открыто.

Примеры

В следующем примере создается экземпляр производного класса OleDbCommand, а затем выполняется. Для этого методу передается строка, которая является инструкцией SQL SELECT, и строка, используемая для подключения к источнику данных.

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.

ExecuteNonQuery Хотя не возвращает строк, все выходные параметры или возвращаемые значения, сопоставленные с параметрами, заполняются данными.

Операторы UPDATE, INSERT и DELETE возвращают количество строк, которые были обработаны с их помощью. Для всех прочих типов операторов возвращаемым значением является -1.