IDbCommand.ExecuteScalar Método

Definición

Espacio de nombres:

System.Data

Ensamblado:

System.Data.Common.dll

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

public:
 System::Object ^ ExecuteScalar();

public object? ExecuteScalar ();

abstract member ExecuteScalar : unit -> obj

Public Function ExecuteScalar () As Object

Devoluciones

Object

Primera columna de la primera fila del conjunto de resultados.

Ejemplos

En el ejemplo siguiente se crea una instancia de la clase derivada, y, a continuación, SqlCommandse ejecuta mediante ExecuteScalar. El ejemplo se pasa una cadena que es una instrucción Transact-SQL que devuelve un resultado agregado y una cadena que se va a usar para conectarse al origen de datos.

public void CreateSqlCommand(
    string queryString, SqlConnection connection)
{
    SqlCommand command = new
        SqlCommand(queryString, connection);
    command.Connection.Open();
    command.ExecuteScalar();
    connection.Close();
}

Public Sub CreateSqlCommand( _
    queryString As String, connection As SqlConnection)

    Dim command As New SqlCommand(queryString, 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 mediante los datos devueltos por .IDataReader

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

CommandText = "select count(*) as NumberOfRegions from region";  
Int32 count = (int) ExecuteScalar();  

Si no se encuentra la primera columna de la primera fila del conjunto de resultados, se devuelve una referencia nula (Nothing en Visual Basic). Si el valor de la base de datos es null, la consulta devuelve DBNull.Value.