Поделиться через


OdbcCommand.ExecuteNonQuery Метод

Определение

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

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

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

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

Реализации

Исключения

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

-или-

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

Комментарии

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

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

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

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

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

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

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