IDbCommand.ExecuteScalar Метод

Определение

Пространство имен:

System.Data

Сборка:

System.Data.dll

Выполняет запрос и возвращает первый столбец первой строки в наборе результатов, возвращенный запросом. Дополнительные столбцы или строки игнорируются.

public:
 System::Object ^ ExecuteScalar();

public object ExecuteScalar();

abstract member ExecuteScalar : unit -> obj

Public Function ExecuteScalar () As Object

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

Object

Первый столбец первой строки в наборе результатов.

Примеры

В следующем примере создается экземпляр производного класса, SqlCommandа затем выполняется с помощью ExecuteScalar. В примере передается строка, которая является оператором Transact-SQL, который возвращает статистический результат, и строку, используемую для подключения к источнику данных.

public void CreateSqlCommand(
    string queryString, SqlConnection connection)
{
    SqlCommand command = new
        SqlCommand(queryString, connection);
    command.Connection.Open();
    command.ExecuteScalar();
    connection.Close();
}

Public Sub CreateSqlCommand( _
    queryString As String, connection As SqlConnection)

    Dim command As New SqlCommand(queryString, connection)
    command.Connection.Open()
    command.ExecuteScalar()
    connection.Close()
End Sub

Комментарии

ExecuteScalar Используйте метод для получения одного значения (например, статистического значения) из базы данных. Для этого требуется меньше кода, чем использование ExecuteReader метода, а затем выполнение операций, необходимых для создания одного значения с помощью данных, возвращаемых методом IDataReader.

Типичный ExecuteScalar запрос можно отформатировать, как показано в следующем примере C#:

CommandText = "select count(*) as NumberOfRegions from region";
Int32 count = (int) ExecuteScalar();

Если первый столбец первой строки в результирующем наборе не найден, возвращается пустая ссылка (Nothing в Visual Basic). Если значение в базе данных равно null, запрос возвращается DBNull.Value.