Les interfaces IDataReader et IDataRecord permettent à une classe qui hérite d'implémenter une classe DataReader. Cela offre un moyen de lire un ou plusieurs flux de données avant uniquement de jeux de résultats. Pour plus d'informations sur les classes DataReader, consultez Extraction de données à l'aide d'un DataReader. Pour plus d'informations sur la manière d'implémenter des fournisseurs de données .NET Framework, consultez Implementing a .NET Framework Data Provider.

Une application ne crée pas directement d'instance de l'interface IDataRecord, mais crée une instance d'une classe qui hérite de IDataRecord. Généralement, cela s'effectue en obtenant un DataReader à l'aide de la méthode ExecuteReader de l'objet Command.

Les classes qui héritent de IDataRecord doivent implémenter tous les membres hérités et définissent généralement des membres supplémentaires pour ajouter des fonctionnalités propres au fournisseur.

Les fournisseurs implémentant DataReader doivent exposer des données dans des types CLR (Common Language Runtime). La contrainte de type est définie pour certains types non compris dans le CLR. Ces valeurs sont accessibles en tant que types de remplacement, conformes aux types CLR. Par exemple, le tableau suivant répertorie des correspondances suggérées entre les types de données OLE DB et les types CLR, ainsi que les types de remplacement entre parenthèses dans la colonne Type CLR.

L'exemple suivant crée des instances des classes dérivées (SqlConnection, SqlCommand et SqlDataReader). L'exemple lit les données, en les écrivant dans la console. Enfin, l'exemple ferme SqlDataReader, puis 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 Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

.NET Compact Framework