OracleCommand.ExecuteNonQuery Метод

Определение

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

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 возвращают количество строк, которые были обработаны с их помощью.For UPDATE, INSERT, and DELETE statements, the return value is the number of rows affected by the command. Для инструкций CREATE TABLE и DROP TABLE возвращаемое значение равно 0.For CREATE TABLE and DROP TABLE statements, the return value is 0. Для всех прочих типов операторов возвращаемым значением является -1.For all other types of statements, the return value is -1.

Реализации

Исключения

Подключение не существует.The connection does not exist.

- или --or-

Соединение не открыто.The connection is not open.

Примеры

В следующем примере создается OracleCommand и выполняется с помощью ExecuteNonQuery .The following example creates an OracleCommand and then executes it by 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 database.

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.You can use ExecuteNonQuery to perform catalog operations (for example, querying the structure of a database or creating 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 ExecuteNonQuery does not return any 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. Для инструкций CREATE TABLE и DROP TABLE возвращаемое значение равно 0.For CREATE TABLE and DROP TABLE statements, the return value is 0. Для всех прочих типов операторов возвращаемым значением является -1.For all other types of statements, the return value is -1. Если происходит откат, возвращаемое значение также равно-1.If a rollback occurs, the return value is also -1.

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