DbCommand.ExecuteScalar Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Выполняет команду и возвращает первый столбец первой строки в первом возвращенном результирующем наборе. Все остальные столбцы, строки и результирующие наборы игнорируются.
public:
abstract System::Object ^ ExecuteScalar();
public abstract object ExecuteScalar ();
public abstract object? ExecuteScalar ();
abstract member ExecuteScalar : unit -> obj
Public MustOverride Function ExecuteScalar () As Object
Возвращаемое значение
Первый столбец первой строки в первом результирующем наборе.
Реализации
Комментарии
Используйте метод , ExecuteScalar чтобы получить одно значение (например, агрегированное) из базы данных. Для этого требуется меньше кода, чем при использовании ExecuteReader метода и выполнении операций, необходимых для создания одного значения с использованием данных, возвращаемых DbDataReader.
Если первый столбец первой строки в результирующем наборе не найден, возвращается пустая ссылка (Nothing
в Visual Basic). Если значение в базе данных равно null
, запрос возвращает DBNull.Value
.