Las interfaces IDataReader y IDataRecord permiten que una clase heredera implemente una clase DataReader. Esto proporciona una manera de leer una o varias secuencias de tipo sólo hacia delante de los 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 cómo implementar proveedores de datos de .NET Framework, vea Implementing a .NET Framework Data Provider.

Una aplicación no crea una instancia de la interfaz IDataRecord directamente, sino que crea una instancia de una clase que hereda de IDataRecord. Normalmente, esto se realiza obteniendo un objeto DataReader a través del método ExecuteReader del objeto Command.

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

Los proveedores que implementan un DataReader son necesarios para exponer datos en tipos de Common Language Runtime (CLR). La conversión de tipos se define para algunos tipos no incluidos en CLR. Se puede obtener acceso a estos valores como tipos alternativos que siguen los tipos CLR. Como ejemplo, en la tabla siguiente se enumeran asignaciones sugeridas de tipos de datos OLE DB a tipos CLR y se relacionan tipos alternativos entre paréntesis en la columna Tipo CLR.

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, en el ejemplo se cierra el objeto SqlDataReader y, a continuación, el objeto 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