SqlClient.ExecuteNonQuery

SqlClient ExecuteNonQuery - метод

Nemiro.Data.dll

Выполняет запрос и возвращает количество задействованных в инструкции строк данных. Данный метод используется совместно со свойствами CommandType, CommandText и Parameters.

Пространство имён: Nemiro.Data.Sql
Сборка: Nemiro.Data (в Nemiro.Data.dll) Версия: 2.11.4.126 (2.11.4.126)

Синтаксис

C++

Скопировать в буфер обмена Печать

public int ExecuteNonQuery()

public int ExecuteNonQuery()

Public Function ExecuteNonQuery As Integer

Public Function ExecuteNonQuery As Integer

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

Тип: Int32

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

Если запрос не коснулся ни одной строки данных, возвращает ноль.

Исключения

Исключение	Условие
SqlException	Исключение возникает при возврате SQL Server предупреждения или ошибки.
ValueForIdentityException	Исключение происходит, если у ключевого свойства отсутствует флаг Identity и при этом соответствующее поле таблицы является числовым счетчиком.
StringOrBinaryDataWouldBeTruncatedException	Исключение возникает, если в некоторые поля таблицы добавляются значения, объем которых превышает допустимый размер поля таблицы.

Заметки

Параметры кэширования при работе с этим методом игнорируются.

Примеры

C++

Скопировать в буфер обмена Печать

using (SqlClient client = new SqlClient())
{
  // формируем запрос
  client.CommandText = "UPDATE messages SET hits = hits + 1 WHERE id = 42";
  // выполняем запрос 
  int used = client.ExecuteNonQuery();
  // выводим результат в консоль
  Console.WriteLine("Обновлено {0} строк", used);
}

using (SqlClient client = new SqlClient())
{
  // формируем запрос
  client.CommandText = "UPDATE messages SET hits = hits + 1 WHERE id = 42";
  // выполняем запрос 
  int used = client.ExecuteNonQuery();
  // выводим результат в консоль
  Console.WriteLine("Обновлено {0} строк", used);
}

Using client As New SqlClient()
  ' формируем запрос
  client.CommandText = "UPDATE messages SET hits = hits + 1 WHERE id = 42" 
  ' выполняем запрос 
  Dim used As Integer = client.ExecuteNonQuery()
  ' выводим результат в консоль
  Console.WriteLine("Обновлено {0} строк", used)
End Using

Using client As New SqlClient()
  ' формируем запрос
  client.CommandText = "UPDATE messages SET hits = hits + 1 WHERE id = 42" 
  ' выполняем запрос 
  Dim used As Integer = client.ExecuteNonQuery()
  ' выводим результат в консоль
  Console.WriteLine("Обновлено {0} строк", used)
End Using

См. также

SqlClient - класс

ExecuteNonQuery - перегрузка

Nemiro.Data.Sql - пространство имён

SqlClient GetData

SqlClient GetTable

SqlClient GetRow

SqlClient ExecuteScalar