OleDbCommand.ExecuteScalar Método

Definição

Espaço de Nomes:
System.Data.OleDb
Assemblagem:
System.Data.dll

Executa a consulta e devolve a primeira coluna da primeira linha do conjunto de resultados devolvida pela consulta. Colunas ou linhas adicionais são ignoradas.

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

Devoluções

Object

A primeira coluna da primeira linha do conjunto de 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 dentro de um contexto de transação que difere do contexto em que a ligação foi originalmente listada.

Exemplos

O exemplo seguinte cria um OleDbCommand e depois executa-o usando ExecuteScalar. O exemplo recebe uma string que é uma instrução SQL que devolve um resultado agregado, e uma string para usar para se ligar à 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

Observações

Use o ExecuteScalar método para recuperar um único valor, por exemplo, um valor agregado, a partir de uma fonte de dados. Isto requer menos código do que usar o ExecuteReader método, e depois realizar as operações necessárias para gerar o valor único usando os dados devolvidos 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();

Aplica-se a

Ver também