OleDbCommand.ExecuteScalar Метод

  • Ссылка

Определение

Пространство имен:
System.Data.OleDb
Сборка:
System.Data.OleDb.dll
Сборка:
System.Data.dll
Пакет:
System.Data.OleDb v8.0.1
Пакет:
System.Data.OleDb v9.0.0-rc.2.24473.5
Исходный код:
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();

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

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