DbCommand.ExecuteScalar Método

Definición

Cuando se invalida en una clase derivada, ejecuta la consulta y devuelve la primera columna de la primera fila del conjunto de resultados que devuelve la consulta.When overridden in a derived class, executes the query and returns the first column of the first row in the result set returned by the query. Se omiten todas las demás columnas y filas.All other columns and rows are ignored.

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

Devoluciones

Object

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

Implementaciones

Comentarios

Use el ExecuteScalar método 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 ExecuteReader método y la realización de las operaciones necesarias para generar el valor único utilizando los datos devueltos por DbDataReader .This requires less code than using the ExecuteReader method and performing the operations necessary to generate the single value using the data returned by a DbDataReader.

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