IDbCommand.ExecuteScalar Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 ();public object ExecuteScalar ();abstract member ExecuteScalar : unit -> objPublic Function ExecuteScalar () As ObjectDevoluciones
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.
