IDataRecord Interface

Definitie

public interface class IDataRecord

public interface IDataRecord

type IDataRecord = interface

Public Interface IDataRecord

Afgeleid

System.Data.Common.DbDataReader

System.Data.Common.DbDataRecord

System.Data.EntityClient.EntityDataReader

System.Data.IDataReader

System.Data.IExtendedDataRecord

Meer…

Voorbeelden

In het volgende voorbeeld worden exemplaren van de afgeleide klassen, SqlConnection, SqlCommanden SqlDataReader. In het voorbeeld worden de gegevens gelezen en naar de console geschreven. Ten slotte sluit het voorbeeld de SqlDataReader, en vervolgens de 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

Opmerkingen

Met de IDataReader en IDataRecord interfaces kan een overnemende klasse een DataReader klasse implementeren. Dit biedt een manier om een of meer doorstuurstreams met resultatensets te lezen. Zie Gegevens ophalen met behulp van een DataReader voor meer informatie over DataReader klassen.

Een toepassing maakt geen exemplaar van de IDataRecord interface rechtstreeks, maar maakt een exemplaar van een klasse die wordt overgenomen IDataRecord. Normaal gesproken doet u dit door een DataReader via de ExecuteReader methode van het Command object te verkrijgen.

Klassen die overnemen IDataRecord , moeten alle overgenomen leden implementeren en definiëren doorgaans aanvullende leden om providerspecifieke functionaliteit toe te voegen.

Providers die een DataReader implementatie uitvoeren, zijn vereist om gegevens beschikbaar te maken in CLR-typen (Common Language Runtime). Type coercion is gedefinieerd voor sommige typen die niet zijn opgenomen in de CLR. Deze waarden kunnen worden geopend als alternatieve typen die voldoen aan CLR-typen. In de volgende tabel ziet u bijvoorbeeld voorgestelde toewijzingen van OLE DB-gegevenstypen aan CLR-typen, met alternatieve typen haakjes.