DbCommand.ExecuteNonQuery Метод
В этой статье
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Выполняет команду для объекта соединения, возвращая количество затронутых строк.
public:
abstract int ExecuteNonQuery();
public abstract int ExecuteNonQuery ();
abstract member ExecuteNonQuery : unit -> int
Public MustOverride Function ExecuteNonQuery () As Integer
Число обработанных строк.
Можно использовать для ExecuteNonQuery выполнения операций с каталогом (например, для запроса структуры базы данных или создания объектов базы данных, таких как таблицы), или для изменения данных в базе данных с помощью инструкций UPDATE, INSERT или DELETE.
Хотя ExecuteNonQuery строки не возвращаются, все выходные параметры или возвращаемые значения, сопоставленные с параметрами, заполняются данными.
Операторы UPDATE, INSERT и DELETE возвращают количество строк, которые были обработаны с их помощью. Для всех прочих типов операторов возвращаемым значением является -1.
Продукт | Версии |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
UWP | 10.0 |