IDbCommand.ExecuteScalar Método

Definición

Ejecuta la consulta y devuelve la primera columna de la primera fila del conjunto de resultados devuelto por la consulta.Executes the query, and returns the first column of the first row in the resultset returned by the query. Las columnas o filas adicionales no se tienen en cuenta.Extra columns or rows are ignored.

public:
 System::Object ^ ExecuteScalar();
public object ExecuteScalar ();
abstract member ExecuteScalar : unit -> obj
Public Function ExecuteScalar () As Object

Devoluciones

Primera columna de la primera fila del conjunto de resultados.The first column of the first row in the resultset.

Ejemplos

En el ejemplo siguiente se crea una instancia de la clase derivada SqlCommandy, a continuación, se ejecuta con ExecuteScalar.The following example creates an instance of the derived class, SqlCommand, and then executes it using ExecuteScalar. En el ejemplo se pasa una cadena que es una instrucción Transact-SQL que devuelve un resultado agregado y una cadena que se utiliza para conectarse al origen de datos.The example is passed a string that is a Transact-SQL statement that returns an aggregate result, and a string to use to connect to the data source.

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 método ExecuteScalar para recuperar un valor único (por ejemplo, un valor agregado) de una base de datos.Use the ExecuteScalar method to retrieve a single value (for example, an aggregate value) from a database. Esto requiere menos código que el uso del método ExecuteReader y, a continuación, realizar las operaciones necesarias para generar el valor único utilizando los datos devueltos por un IDataReader.This requires less code than using the ExecuteReader method, and then performing the operations necessary to generate the single value using the data returned by an IDataReader.

Se puede dar formato A una consulta de ExecuteScalar típica como C# en el ejemplo siguiente:A typical ExecuteScalar query can be formatted as in the following C# example:

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).If the first column of the first row in the result set is not found, a null reference (Nothing in Visual Basic) is returned. Si el valor de la base de datos es null, la consulta devuelve DBNull.Value.If the value in the database is null, the query returns DBNull.Value.

Se aplica a