SqlClient ExecuteScalar - методNemiro.Data.dll
Выполняет запрос и возвращает первый столбец первой строки из полученного набора данных. Данный метод используется совместно со свойствами CommandType, CommandText и Parameters.

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

public Object ExecuteScalar()

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

Тип: Object

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

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

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

Исключения

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

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

Примеры

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