OleDbCommand.ExecuteScalar Método

Definición

Espacio de nombres:
System.Data.OleDb
Ensamblado:
System.Data.dll

Ejecuta la consulta y devuelve la primera columna de la primera fila del conjunto de resultados devuelto por la consulta. Se omiten columnas o filas adicionales.

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

Devoluciones

Object

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

Implementaciones

ExecuteScalar()

Excepciones

InvalidOperationException

No se puede ejecutar un comando dentro de un contexto de transacción que difiere del contexto en el que se inscribe originalmente la conexión.

Ejemplos

En el ejemplo siguiente se crea OleDbCommand y, 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 valor único, 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 ejemplo de C#siguiente:

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

Se aplica a

Consulte también