OleDbCommand.ExecuteScalar Método

Definição

Namespace:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Pacote:

System.Data.OleDb v8.0.0

Origem:

OleDbCommand.cs

Executa a consulta e retorna a primeira coluna da primeira linha no conjunto de resultados retornado pela consulta. Colunas ou linhas adicionais são ignoradas.

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

public override object? ExecuteScalar ();

override this.ExecuteScalar : unit -> obj

Public Overrides Function ExecuteScalar () As Object

Retornos

Object

A primeira coluna da primeira linha no conjunto resultados, ou uma referência nula se o conjunto de resultados estiver vazio.

Implementações

ExecuteScalar()

Exceções

InvalidOperationException

Não é possível executar um comando em um contexto de transação diferente do contexto no qual a conexão foi inscrita originalmente.

Exemplos

O exemplo a seguir cria um OleDbCommand e o executa usando ExecuteScalar. O exemplo é passado uma cadeia de caracteres que é uma instrução SQL que retorna um resultado agregado e uma cadeia de caracteres a ser usada para se conectar à fonte de dados.

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

Comentários

Use o ExecuteScalar método para recuperar um único valor, por exemplo, um valor agregado, de uma fonte de dados. Isso requer menos código do que usar o ExecuteReader método e, em seguida, executar as operações necessárias para gerar o valor único usando os dados retornados por um OleDbDataReader.

Uma consulta típica ExecuteScalar pode ser formatada como no seguinte exemplo em C#:

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

Confira também

• Trabalhando com comandos