OleDbCommand.ExecuteReader Método

Definición

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
member this.ExecuteReader : unit -> System.Data.OleDb.OleDbDataReader
Public Function ExecuteReader () As OleDbDataReader

Devoluciones

Objeto OleDbDataReader.

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 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 , OleDbConnectionprimero cierre el OleDbDataReader objeto . También debe cerrar el OleDbDataReader objeto si tiene previsto reutilizar un OleDbCommand objeto.

Consulte también

Se aplica a

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
member 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

Objeto OleDbDataReader.

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 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 , OleDbConnectionprimero cierre el OleDbDataReader objeto . También debe cerrar el OleDbDataReader objeto si tiene previsto reutilizar un OleDbCommand objeto. OleDbDataReader Si se crea con CommandBehavior establecido en CloseConnection, al cerrar la OleDbDataReader conexión se cierra automáticamente.

Consulte también

Se aplica a