SqlClient.ExecuteScalar(SqlCommand)

SqlClient ExecuteScalar(SqlCommand) - метод

Nemiro.Data.dll

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

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

Синтаксис

C++

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

public Object ExecuteScalar(
	SqlCommand cmd
)

public Object ExecuteScalar(
	SqlCommand cmd
)

Public Function ExecuteScalar ( 
	cmd As SqlCommand
) As Object

Public Function ExecuteScalar ( 
	cmd As SqlCommand
) As Object

Параметры

cmd: Тип: System.Data.SqlClient SqlCommand

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

Тип: Object

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

Если запрос не дал результатов, возвращает NULL (в Visual Basic .NET - Nothing).

Может вернуть Value, если запрос был успешно выполнен и полученное поле имеет значение NULL.

Исключения

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

Заметки

В большинстве случаев, рекомендуется использовать метод ExecuteScalar без параметров, совместно со свойствами CommandType, CommandText и Parameters. Суть будет примерно такой же, как и с SqlCommand, но работать удобней.

Результат выполнения запроса может кэшироваться, если свойство CacheDuration больше нуля и CacheType имеет отличное от None значение.

Примеры

C++

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

using (SqlClient client = new SqlClient())
{
  // формируем запрос
  SqlCommand cmd = new SqlCommand("SELECT nickname FROM users WHERE id_users = @id_users");
  cmd.Parameters.Add("@id_users", SqlDbType.Int).Value = 1024;
  // выполняем запрос и выводим результат в консоль
  Console.WriteLine("Псевдоним пользователя: {0}", client.ExecuteScalar(cmd));
}

using (SqlClient client = new SqlClient())
{
  // формируем запрос
  SqlCommand cmd = new SqlCommand("SELECT nickname FROM users WHERE id_users = @id_users");
  cmd.Parameters.Add("@id_users", SqlDbType.Int).Value = 1024;
  // выполняем запрос и выводим результат в консоль
  Console.WriteLine("Псевдоним пользователя: {0}", client.ExecuteScalar(cmd));
}

Using client As New SqlClient()
  ' формируем запрос 
  Dim cmd As New SqlCommand("SELECT nickname FROM users WHERE id_users = @id_users")
  cmd.Parameters.Add("@id_users", SqlDbType.Int).Value = 1024 
  ' выполняем запрос и выводим результат в консоль
  Console.WriteLine("Псевдоним пользователя: {0}", client.ExecuteScalar(cmd))
End Using

Using client As New SqlClient()
  ' формируем запрос 
  Dim cmd As New SqlCommand("SELECT nickname FROM users WHERE id_users = @id_users")
  cmd.Parameters.Add("@id_users", SqlDbType.Int).Value = 1024 
  ' выполняем запрос и выводим результат в консоль
  Console.WriteLine("Псевдоним пользователя: {0}", client.ExecuteScalar(cmd))
End Using

См. также

SqlClient - класс

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

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

SqlClient GetData

SqlClient GetTable

SqlClient GetRow

SqlClient ExecuteNonQuery