Compartir vía


OleDbCommand.ExecuteScalar Método

Definición

Ejecuta la consulta y devuelve la primera columna de la primera fila del conjunto de resultados devueltos por la consulta. Las demás columnas o filas no se tienen en cuenta.

public:
 override System::Object ^ ExecuteScalar();
public:
 virtual System::Object ^ ExecuteScalar();
public override object? ExecuteScalar ();
public object ExecuteScalar ();
public override object ExecuteScalar ();
override this.ExecuteScalar : unit -> obj
abstract member ExecuteScalar : unit -> obj
override this.ExecuteScalar : unit -> obj
Public Overrides Function ExecuteScalar () As Object
Public Function ExecuteScalar () As Object

Devoluciones

Primera columna de la primera fila del conjunto de resultados o una referencia NULL si el conjunto de resultados está vacío.

Implementaciones

Excepciones

No se puede ejecutar un comando en un contexto de transacción distinto al contexto en que se incorporó la conexión originalmente.

Ejemplos

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

public void CreateMyOleDbCommand(string queryString,
    OleDbConnection connection)
{
    OleDbCommand command = new OleDbCommand(queryString, connection);
    command.Connection.Open();
    command.ExecuteScalar();
    connection.Close();
}
Public Sub CreateMyOleDbCommand(queryString As String, _
    connection As OleDbConnection)
    Dim command As New OleDbCommand(queryString, connection)
    command.Connection.Open()
    command.ExecuteScalar()
    connection.Close()
End Sub

Comentarios

Use el ExecuteScalar método para recuperar un único valor, por ejemplo, un valor agregado de un origen 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 .OleDbDataReader

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

CommandText = "SELECT COUNT(*) FROM region";  
Int32 count = (Int32) ExecuteScalar();  

Se aplica a

Consulte también