OdbcCommand.ExecuteNonQuery Метод

Определение

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

System.Data.Odbc

Сборка:

System.Data.Odbc.dll

Пакет:

System.Data.Odbc v8.0.0

Исходный код:

OdbcCommand.cs

Выполняет оператор 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 возвращают количество строк, которые были обработаны с их помощью. Для всех прочих типов операторов возвращаемым значением является -1.

Исключения

InvalidOperationException

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

-или-

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

Комментарии

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

Можно также использовать для ExecuteNonQuery выполнения нескольких инструкций SQL, если базовый драйвер ODBC поддерживает эту функцию. В этом случае возвращаемое значение — это количество строк, на которые влияют все инструкции в команде.

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

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

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

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

• Выполнение команды