OleDbCommand.ExecuteScalar Метод

Определение

Выполняет запрос и возвращает первый столбец первой строки результирующего набора, возвращаемого запросом.Executes the query, and returns the first column of the first row in the result set returned by the query. Дополнительные столбцы или строки не обрабатываются.Additional columns or rows are ignored.

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

Возвраты

Первый столбец первой строки набора результатов или пустая ссылка, если набор результатов пуст.The first column of the first row in the result set, or a null reference if the result set is empty.

Реализации

Исключения

Не удается выполнить команду в контексте транзакции, отличающемся от контекста, в котором подключение было изначально зарегистрировано.Cannot execute a command within a transaction context that differs from the context in which the connection was originally enlisted.

Примеры

В следующем примере создается OleDbCommand, а затем выполняется с помощью ExecuteScalar.The following example creates an OleDbCommand and then executes it using ExecuteScalar. В примере передается строка, которая представляет собой инструкцию SQL, которая возвращает статистический результат, и строку, используемую для подключения к источнику данных.The example is passed a string that is an SQL statement that returns an aggregate result, and a string to use to connect to the data source.

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 для получения одного значения, например статистического значения, из источника данных.Use the ExecuteScalar method to retrieve a single value, for example, an aggregate value, from a data source. Для этого требуется меньше кода, чем при использовании метода ExecuteReader, а затем выполняются операции, необходимые для создания единственного значения с использованием данных, возвращаемых OleDbDataReader.This requires less code than using the ExecuteReader method, and then performing the operations that are required to generate the single value using the data returned by an OleDbDataReader.

Типичный ExecuteScalar запрос можно отформатировать, как показано C# в следующем примере:A typical ExecuteScalar query can be formatted as in the following C# example:

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

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

Дополнительно