OleDbCommand.ExecuteReader 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

Envía una propiedad CommandText a la propiedad Connection y compila un objeto OleDbDataReader.

Sobrecargas

ExecuteReader()	Envía una propiedad CommandText a la propiedad Connection y compila un objeto OleDbDataReader.
ExecuteReader(CommandBehavior)	Envía CommandText a Connection y crea un objeto OleDbDataReader con uno de los valores de CommandBehavior.

ExecuteReader()

Envía una propiedad CommandText a la propiedad Connection y compila un objeto OleDbDataReader.

public:
 System::Data::OleDb::OleDbDataReader ^ ExecuteReader();

public System.Data.OleDb.OleDbDataReader ExecuteReader ();

override this.ExecuteReader : unit -> System.Data.OleDb.OleDbDataReader

Public Function ExecuteReader () As OleDbDataReader

Devoluciones

OleDbDataReader

Objeto OleDbDataReader.

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 un OleDbCommandy, a continuación, se ejecuta pasando una cadena que es una instrucción SELECT de SQL y una cadena que se va a usar para conectarse al origen de datos.

public void CreateReader(string connectionString, string queryString)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbCommand command = new OleDbCommand(queryString, connection);
        connection.Open();
        OleDbDataReader reader = command.ExecuteReader();

        while (reader.Read())
        {
            Console.WriteLine(reader[0].ToString());
        }
        reader.Close();
    }
}

Public Sub CreateReader(ByVal connectionString As String, _
    ByVal queryString As String)

    Using connection As New OleDbConnection(connectionString)
        Dim command As New OleDbCommand(queryString, connection)

        connection.Open()

        Dim reader As OleDbDataReader = command.ExecuteReader()
        While reader.Read()
            Console.WriteLine(reader(0).ToString())
        End While
        reader.Close()
    End Using
End Sub

Comentarios

Cuando la CommandType propiedad se establece StoredProcedureen , la CommandText propiedad debe establecerse en el nombre del procedimiento almacenado. El comando ejecuta este procedimiento almacenado cuando se llama a ExecuteReader.

Antes de cerrar OleDbConnection, primero cierre el OleDbDataReader objeto . También debe cerrar el OleDbDataReader objeto si planea reutilizar un OleDbCommand objeto.

Consulte también

• Trabajar con comandos

ExecuteReader(CommandBehavior)

Envía CommandText a Connection y crea un objeto OleDbDataReader con uno de los valores de CommandBehavior.

public:
 System::Data::OleDb::OleDbDataReader ^ ExecuteReader(System::Data::CommandBehavior behavior);

public System.Data.OleDb.OleDbDataReader ExecuteReader (System.Data.CommandBehavior behavior);

override this.ExecuteReader : System.Data.CommandBehavior -> System.Data.OleDb.OleDbDataReader

Public Function ExecuteReader (behavior As CommandBehavior) As OleDbDataReader

Parámetros

behavior

CommandBehavior

Uno de los valores de CommandBehavior.

Devoluciones

OleDbDataReader

Objeto OleDbDataReader.

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 un OleDbCommandy, a continuación, se ejecuta pasando una cadena que es una instrucción SELECT de Transact-SQL y una cadena que se va a usar para conectarse al origen de datos. El valor de CommandBehavior está establecido en CloseConnection.

public void CreateMyOleDbDataReader(string queryString,string connectionString)
{
   OleDbConnection connection = new OleDbConnection(connectionString);
   OleDbCommand command = new OleDbCommand(queryString, connection);
   connection.Open();
   OleDbDataReader reader = command.ExecuteReader(CommandBehavior.CloseConnection);
   while(reader.Read())
   {
      Console.WriteLine(reader.GetString(0));
   }
   reader.Close();
   //Implicitly closes the connection because CommandBehavior.CloseConnection was specified.
}

Public Sub CreateMyOleDbDataReader(queryString As String, _
    connectionString As String)
    Dim connection As New OleDbConnection(connectionString)
    Dim command As New OleDbCommand(queryString, connection)
    connection.Open()
    Dim reader As OleDbDataReader = command.ExecuteReader(CommandBehavior.CloseConnection)
    While reader.Read()
        Console.WriteLine(reader.GetString(0))
    End While
    reader.Close()
    'Implicitly closes the connection because CommandBehavior.CloseConnection was specified.
 End Sub

Comentarios

Cuando se especifica SingleRow con el ExecuteReader método del OleDbCommand objeto , el proveedor de datos de .NET Framework para OLE DB realiza el enlace mediante la interfaz IRow de OLE DB si está disponible. De lo contrario, usa la interfaz IRowset . Además, si se espera que la instrucción SQL devuelva una única fila, se puede mejorar el rendimiento de la aplicación especificando SingleRow.

Cuando la CommandType propiedad se establece StoredProcedureen , la CommandText propiedad debe establecerse en el nombre del procedimiento almacenado. El comando ejecuta este procedimiento almacenado cuando se llama a ExecuteReader.

OleDbDataReader admite un modo especial que permite leer valores binarios grandes de forma eficaz. Para obtener más información, vea la SequentialAccess configuración de CommandBehavior.

Antes de cerrar OleDbConnection, primero cierre el OleDbDataReader objeto . También debe cerrar el OleDbDataReader objeto si planea reutilizar un OleDbCommand objeto. OleDbDataReader Si se crea con establecido en CommandBehaviorCloseConnection, al cerrar se OleDbDataReader cierra automáticamente la conexión.

Consulte también

• Trabajar con comandos