Esta documentación está archivada y no tiene mantenimiento.

OdbcDataReader (Clase)

Actualización: noviembre 2007

Proporciona el modo de lectura de una secuencia de filas de datos de tipo sólo avance de un origen de datos. Esta clase no se puede heredar.

Espacio de nombres:  System.Data.Odbc
Ensamblado:  System.Data (en System.Data.dll)

public sealed class OdbcDataReader : DbDataReader
public final class OdbcDataReader extends DbDataReader
public final class OdbcDataReader extends DbDataReader

Para crear OdbcDataReader, se debe llamar al método ExecuteReader del objeto OdbcCommand, en lugar de utilizar directamente un constructor.

Mientras se está utilizando OdbcDataReader, el objeto OdbcConnection asociado está ocupado dando servicio a OdbcDataReader, y en OdbcConnection no se puede realizar ninguna otra operación, excepto la de cerrar. Esto es así hasta que se llama al método Close de OdbcDataReader. Por ejemplo, no se pueden recuperar parámetros de salida hasta después de llamar a Close.

Los cambios que realiza otro proceso o subproceso en un conjunto de resultados mientras se leen los datos, pueden ser visibles para el usuario de OdbcDataReader. Sin embargo, el comportamiento preciso depende del controlador y del tiempo.

IsClosed y RecordsAffected son las únicas propiedades a las que se puede llamar después de cerrarse OdbcDataReader. En algunos casos, es necesario llamar a Close antes de llamar a RecordsAffected.

En el siguiente ejemplo se crean OdbcConnection, OdbcCommand y OdbcDataReader. En el ejemplo se leen los datos y se escriben en la consola. Por último, se cierra OdbcDataReader y, a continuación, OdbcConnection.

public static void ReadData(string connectionString)
{
    string queryString = "SELECT DISTINCT CustomerID FROM Orders";

    using (OdbcConnection connection = new OdbcConnection(connectionString))
    {
        OdbcCommand command = new OdbcCommand(queryString, connection);

        connection.Open();

        // Execute the DataReader and access the data.
        OdbcDataReader reader = command.ExecuteReader();
        while (reader.Read())
        {
            Console.WriteLine("CustomerID={0}", reader[0]);
        }

        // Call Close when done reading.
        reader.Close();
    }
}


Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1
Mostrar: