Метод SqlCeCommand.ExecuteNonQuery
Выполняет инструкцию SQL для соединения SqlCeConnection и возвращает число обработанных строк.
Пространство имен: System.Data.SqlServerCe
Сборка: System.Data.SqlServerCe (в System.Data.SqlServerCe.dll)
Синтаксис
'Декларация
Public Overrides Function ExecuteNonQuery As Integer
'Применение
Dim instance As SqlCeCommand
Dim returnValue As Integer
returnValue = instance.ExecuteNonQuery()
public override int ExecuteNonQuery()
public:
virtual int ExecuteNonQuery() override
abstract ExecuteNonQuery : unit -> int
override ExecuteNonQuery : unit -> int
public override function ExecuteNonQuery() : int
Возвращаемое значение
Тип: System.Int32
Число обработанных строк.
Реализует
Исключения
Исключение | Условие |
---|---|
InvalidOperationException | Соединение не существует. -или- Соединение не открыто. -или- Не удается выполнить команду в контексте транзакции, который отличается от контекста, в котором первоначально было прикреплено соединение. |
Замечания
Метод ExecuteNonQuery может применяться для выполнения операций с каталогом, например для запроса структуры базы данных или создания в ней таблиц и других объектов. Метод ExecuteNonQuery также может выполнять изменение данных в базе данных инструкциями UPDATE, INSERT или DELETE без использования объекта DataSet.
Важно!
Метод ExecuteNonQuery не поддерживает курсор и поэтому не устанавливает блокировки в базе данных. Если необходимо выполнить команду, для которой необходима блокировка, метод ExecuteNonQuery применять не следует. Вместо этого вызовите метод ExecuteReader.
Для инструкций UPDATE, INSERT и DELETE возвращается число строк, обработанных командой. Для остальных инструкций DML возвращается значение -1.
Для инструкций DDL (например CREATE TABLE или ALTER TABLE) возвращается значение 0.
Примечание
В этом состоит отличие от System.Data.SqlClient.
Примеры
В следующем примере создается объект SqlCeCommand, для которого выполняется команда вызовом метода ExecuteNonQuery. Следующему примеру передается строка, содержащая инструкцию SQL (UPDATE, INSERT или DELETE), и строка соединения с источником данных.
conn.Open()
Dim cmd As New SqlCeCommand("INSERT INTO foo (col1) VALUES (1)", conn)
cmd.ExecuteNonQuery()
conn.Close()
conn.Open();
SqlCeCommand cmd = new SqlCeCommand("INSERT INTO foo (col1) VALUES (1)", conn);
cmd.ExecuteNonQuery();
conn.Close();