OleDbCommand.ExecuteScalar Método

Definición

Espacio de nombres:

System.Data.OleDb

Ensamblado:

System.Data.OleDb.dll

Paquete:

System.Data.OleDb v9.0.0-rc.2.24473.5

Source:

OleDbCommand.cs

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 override object? ExecuteScalar ();

override this.ExecuteScalar : unit -> obj

Public Overrides Function ExecuteScalar () As Object

Devoluciones

Object

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

Implementaciones

ExecuteScalar()

Excepciones

InvalidOperationException

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();  

Consulte también

• Trabajar con comandos