Las interfaces IDataReader y IDataRecord permiten que una clase heredada implemente una clase DataReader, que proporciona un medio para leer una o más secuencias de sólo avance de conjuntos de resultados. Para obtener más información sobre las clases DataReader, vea Recuperar datos mediante DataReader. Para obtener más información sobre la implementación de proveedores de datos de .NET Framework, vea Implementing a .NET Framework Data Provider.

Una aplicación no crea una instancia de la interfaz IDataReader directamente, sino que la crea de una clase que hereda de IDataReader.

Las clases que heredan de IDataReader deben implementar los miembros heredados y suelen definir miembros adicionales para agregar la funcionalidad específica de proveedor.

Los cambios realizados en un conjunto de resultados por otro proceso o subproceso mientras se están leyendo los datos pueden ser visibles para el usuario de una clase que implementa un IDataReader. Sin embargo, el comportamiento preciso depende del proveedor y del tiempo.

Notas para los implementadores Para potenciar la coherencia entre los proveedores de datos de .NET Framework, asigne a la clase heredada un nombre con el formato Prv Command, donde Prv es el prefijo uniforme que se asigna a todas las clases de un espacio de nombres de proveedor de datos de .NET Framework específico. Por ejemplo, Sql es el prefijo de la clase SqlDataAdapter en el espacio de nombres System.Data.SqlClient. Los usuarios no crean directamente una instancia de la clase DataReader. En su lugar, obtienen el DataReader mediante el método ExecuteReader del objeto Command. Por tanto, se deben marcar los constructores DataReader como internos.

En el ejemplo siguiente se crean instancias de las clases derivadas SqlConnection, SqlCommand y SqlDataReader. En el ejemplo se leen los datos y se escriben en la consola. Por último, el ejemplo cierra SqlDataReader y, a continuación, SqlConnection.

Private Sub ReadOrderData(ByVal connectionString As String)
    Dim queryString As String = _
        "SELECT OrderID, CustomerID FROM dbo.Orders;"

    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)
        connection.Open()

        Dim reader As SqlDataReader = command.ExecuteReader()

        ' Call Read before accessing data.
        While reader.Read()
            Console.WriteLine(String.Format("{0}, {1}", _
                reader(0), reader(1)))
        End While

        ' Call Close when done reading.
        reader.Close()
    End Using
End Sub

private static void ReadOrderData(string connectionString)
{
    string queryString =
        "SELECT OrderID, CustomerID FROM dbo.Orders;";

    using (SqlConnection connection =
               new SqlConnection(connectionString))
    {
        SqlCommand command =
            new SqlCommand(queryString, connection);
        connection.Open();

        SqlDataReader reader = command.ExecuteReader();

        // Call Read before accessing data.
        while (reader.Read())
        {
            Console.WriteLine(String.Format("{0}, {1}",
                reader[0], reader[1]));
        }

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

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

.NET Framework

.NET Compact Framework