OracleCommand.ExecuteScalar Método

  • Referência

Definição

Namespace:
System.Data.OracleClient
Assembly:
System.Data.OracleClient.dll

Executa a consulta e retorna a primeira coluna da primeira linha do conjunto de resultados retornado pela consulta como um tipo de dados do .NET. Colunas ou linhas extra 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

Retornos

Object

A primeira coluna da primeira linha no conjunto de resultados como um tipo de dados do .NET, ou uma referência nula, se o conjunto de resultados estiver vazio ou se o resultado for um REF CURSOR.

Implementações

ExecuteScalar()

Exemplos

O exemplo a seguir cria um OracleCommand e o executa usando ExecuteScalar. O exemplo é passado uma cadeia de caracteres que é uma instrução SQL que retorna um resultado de agregação e uma cadeia de caracteres a ser usada para se conectar ao banco de dados.

public void CreateOracleCommand(string myScalarQuery, OracleConnection connection)
 {
    OracleCommand command = new OracleCommand(myScalarQuery, connection);
    command.Connection.Open();
    command.ExecuteScalar();
    connection.Close();
 }

Public Sub CreateOracleCommand(myScalarQuery As String, connection As OracleConnection)
    Dim command As New OracleCommand(myScalarQuery, 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 um banco 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 dos dados retornados por um OracleDataReader.

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

Confira também