DbCommand.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 el comando y devuelve la primera columna de la primera fila del primer conjunto de resultados devuelto. Se omiten todas las demás columnas, filas y conjuntos de resultados.
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
Primera columna de la primera fila del primer conjunto de resultados.
Implementaciones
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 realizar las operaciones necesarias para generar el valor único mediante los datos devueltos por .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). Si el valor de la base de datos es null
, la consulta devuelve DBNull.Value
.