OleDbCommand.ExecuteScalar Метод

Определение

Пространство имен:
System.Data.OleDb
Сборка:
System.Data.OleDb.dll
Сборка:
System.Data.dll
Пакет:
System.Data.OleDb v11.0.0-preview.4.26230.115
Исходный код:
OleDbCommand.cs
Исходный код:
OleDbCommand.cs
Исходный код:
OleDbCommand.cs
Исходный код:
OleDbCommand.cs

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

public:
 override System::Object ^ ExecuteScalar();
public:
 virtual System::Object ^ ExecuteScalar();
public override object? ExecuteScalar();
public object ExecuteScalar();
public override object ExecuteScalar();
override this.ExecuteScalar : unit -> obj
abstract member ExecuteScalar : unit -> obj
override this.ExecuteScalar : unit -> obj
Public Overrides Function ExecuteScalar () As Object
Public Function ExecuteScalar () As Object

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

Object

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

Реализации

ExecuteScalar()

Исключения

InvalidOperationException

Не удается выполнить команду в контексте транзакции, который отличается от контекста, в котором изначально было заказано подключение.

Примеры

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

public void CreateMyOleDbCommand(string queryString,
    OleDbConnection connection)
{
    OleDbCommand command = new OleDbCommand(queryString, connection);
    command.Connection.Open();
    command.ExecuteScalar();
    connection.Close();
}

Public Sub CreateMyOleDbCommand(queryString As String, _
    connection As OleDbConnection)
    Dim command As New OleDbCommand(queryString, connection)
    command.Connection.Open()
    command.ExecuteScalar()
    connection.Close()
End Sub

Комментарии

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

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

CommandText = "SELECT COUNT(*) FROM region";
Int32 count = (Int32) ExecuteScalar();

Применяется к

См. также раздел