OracleCommand.ExecuteNonQuery Метод

Определение

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

System.Data.OracleClient

Сборка:

System.Data.OracleClient.dll

Выполняет оператор SQL применительно к свойству Connection и возвращает количество измененных командой строк.

public:
 override int ExecuteNonQuery();

public override int ExecuteNonQuery ();

override this.ExecuteNonQuery : unit -> int

Public Overrides Function ExecuteNonQuery () As Integer

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

Int32

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

Исключения

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.

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

• Работа с командами