OleDbCommand.ExecuteNonQuery Метод

Определение

Пространство имен:
System.Data.OleDb
Сборка:
System.Data.dll

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

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

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

Int32

Количество затронутых строк.

Реализации

ExecuteNonQuery()

Исключения

InvalidOperationException

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

–или–

Подключение не открыто.

–или–

Не удается выполнить команду в контексте транзакции, который отличается от контекста, в котором изначально было заказано подключение.

Примеры

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

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. Если происходит откат, возвращаемое значение также равно -1.

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

См. также раздел