IDataRecord Interface

Définition

public interface class IDataRecord

public interface IDataRecord

type IDataRecord = interface

Public Interface IDataRecord

Dérivé

System.Data.Common.DbDataReader

System.Data.Common.DbDataRecord

System.Data.EntityClient.EntityDataReader

System.Data.IDataReader

System.Data.IExtendedDataRecord

Plus…

Exemples

L’exemple suivant crée des instances des classes dérivées, SqlConnection, SqlCommandet SqlDataReader. L’exemple lit les données, en l’écrivant dans la console. Enfin, l’exemple ferme , SqlDataReaderpuis le SqlConnection.

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())
        {
            ReadSingleRow((IDataRecord)reader);
        }

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

private static void ReadSingleRow(IDataRecord dataRecord)
{
    Console.WriteLine(String.Format("{0}, {1}", dataRecord[0], dataRecord[1]));
}

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()
            ReadSingleRow(CType(reader, IDataRecord))
        End While

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

Private Sub ReadSingleRow(ByVal record As IDataRecord)
   Console.WriteLine(String.Format("{0}, {1}", record(0), record(1)))
End Sub

Remarques

Les IDataReader interfaces permettent IDataRecord à une classe héritée d’implémenter une DataReader classe. Cela permet de lire un ou plusieurs flux vers l’avant uniquement des jeux de résultats. Pour plus d’informations sur DataReader les classes, consultez Récupération de données à l’aide d’un DataReader.

Une application ne crée pas directement une instance de l’interface IDataRecord , mais crée une instance d’une classe qui hérite IDataRecord. En règle générale, vous effectuez cette opération en obtenant une DataReader par le biais de la ExecuteReader méthode de l’objet Command .

Les classes qui héritent 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 spécifiques au fournisseur.

Les fournisseurs implémentant un DataReader sont nécessaires pour exposer des données dans des types CLR (Common Language Runtime). Le forçage de type est défini pour certains types non inclus dans le CLR. Ces valeurs sont accessibles en tant que types alternatifs conformes aux types CLR. Par exemple, le tableau suivant répertorie les mappages suggérés des types de données OLE DB aux types CLR, avec d’autres types entre parenthèses.