OleDbCommand.ExecuteReader Método

Definición

Espacio de nombres:

System.Data.OleDb

Ensamblado:

System.Data.OleDb.dll

Paquete:

System.Data.OleDb v11.0.0-preview.2.26159.112

CommandText Envía a Connection y compila un OleDbDataReaderobjeto .

Sobrecargas

Nombre	Description
ExecuteReader()	CommandText Envía a Connection y compila un OleDbDataReaderobjeto .
ExecuteReader(CommandBehavior)	CommandText Envía a Connectiony compila un OleDbDataReader objeto mediante uno de los CommandBehavior valores .

ExecuteReader()

Source:

OleDbCommand.cs

CommandText Envía a Connection y compila un OleDbDataReaderobjeto .

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

Un objeto OleDbDataReader.

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 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 planea reutilizar un OleDbCommand objeto.

Consulte también

• Trabajar con comandos

ExecuteReader(CommandBehavior)

Source:

OleDbCommand.cs

CommandText Envía a Connectiony compila un OleDbDataReader objeto mediante uno de los CommandBehavior valores .

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 CommandBehavior valores.

Devoluciones

OleDbDataReader

Un objeto OleDbDataReader.

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 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 . Si se espera que la instrucción SQL devuelva solo una sola fila, especificar SingleRow también puede mejorar el rendimiento de la aplicación.

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 planea reutilizar un OleDbCommand objeto. OleDbDataReader Si se crea con establecido CloseConnectionen CommandBehavior , al cerrar la OleDbDataReader conexión se cierra automáticamente.

Consulte también

• Trabajar con comandos