OracleCommand.ExecuteScalar Método

Definición

Espacio de nombres:

System.Data.OracleClient

Ensamblado:

System.Data.OracleClient.dll

Ejecuta la consulta y devuelve la primera columna de la primera fila del conjunto de resultados devuelto por la consulta como un tipo de datos .NET. Las columnas o filas adicionales no se tienen en cuenta.

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

public override object ExecuteScalar ();

override this.ExecuteScalar : unit -> obj

Public Overrides Function ExecuteScalar () As Object

Devoluciones

Object

Primera columna de la primera fila del conjunto de resultados en forma de un tipo de datos .NET, o una referencia nula si el conjunto de resultados está vacío o si el resultado es REF CURSOR.

Ejemplos

En el ejemplo siguiente se crea y OracleCommand , a continuación, se ejecuta mediante ExecuteScalar. El ejemplo se pasa una cadena que es una instrucción SQL que devuelve un resultado agregado y una cadena que se va a usar para conectarse a la base de datos.

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

Comentarios

Use el ExecuteScalar método para recuperar un valor único (por ejemplo, un valor agregado) de una base de datos. Esto requiere menos código que usar el ExecuteReader método y, a continuación, realizar las operaciones necesarias para generar el valor único a partir de los datos devueltos por .OracleDataReader

Se puede dar formato a una consulta típica ExecuteScalar como en el ejemplo de C#siguiente:

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

Consulte también

• Trabajar con comandos