OleDbCommand.ExecuteScalar Метод

Определение

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

System.Data.OleDb

Сборка:

System.Data.OleDb.dll

Пакет:

System.Data.OleDb v9.0.0-preview.3.24172.9

Исходный код:

OleDbCommand.cs

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

public:
 override System::Object ^ ExecuteScalar();

public override object? ExecuteScalar ();

override this.ExecuteScalar : unit -> obj

Public Overrides 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();  

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

• Работа с командами