OracleCommand.ExecuteNonQuery Метод

  • Ссылка

Определение

Пространство имен:
System.Data.OracleClient
Сборка:
System.Data.OracleClient.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

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

Реализации

ExecuteNonQuery()

Исключения

InvalidOperationException

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

-или-

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

Примеры

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

public void CreateOracleCommand(string myExecuteQuery, string connectionString)
{
    using (OracleConnection connection = new OracleConnection(connectionString))
    {
        OracleCommand command = new OracleCommand(myExecuteQuery, connection);
        command.Connection.Open();
        command.ExecuteNonQuery();
    }
}

Public Sub CreateOracleCommand(ByVal myExecuteQuery As String, _
ByVal connectionString As String)
    Using connection As New OracleConnection(connectionString)
        Dim command As New OracleCommand(myExecuteQuery, connection)
        command.Connection.Open()
        command.ExecuteNonQuery()
    End Using
End Sub

Комментарии

Можно использовать для ExecuteNonQuery выполнения операций с каталогом (например, для запроса структуры базы данных или создания объектов базы данных, таких как таблицы), или для изменения данных в базе данных без использования DataSet, выполнив инструкции UPDATE, INSERT или DELETE.

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

Операторы UPDATE, INSERT и DELETE возвращают количество строк, которые были обработаны с их помощью. Для инструкций CREATE TABLE и DROP TABLE возвращаемое значение равно 0. Для всех прочих типов операторов возвращаемым значением является -1. Если происходит откат, возвращаемое значение также равно -1.

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

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