IDataRecord Gränssnitt

Definition

public interface class IDataRecord

public interface IDataRecord

type IDataRecord = interface

Public Interface IDataRecord

Härledda

System.Data.Common.DbDataReader

System.Data.Common.DbDataRecord

System.Data.EntityClient.EntityDataReader

System.Data.IDataReader

System.Data.IExtendedDataRecord

Mer…

Exempel

I följande exempel skapas instanser av de härledda klasserna , SqlConnection, SqlCommandoch SqlDataReader. Exemplet läser igenom data och skriver ut dem till konsolen. Slutligen stänger SqlDataReaderexemplet , och sedan 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

Kommentarer

Gränssnitten IDataReader och IDataRecord gör det möjligt för en ärvande klass att implementera en DataReader klass. Detta ger ett sätt att läsa en eller flera strömmar med endast framåtriktade resultatuppsättningar. Mer information om DataReader klasser finns i Hämta data med hjälp av en DataReader.

Ett program skapar inte en instans av IDataRecord gränssnittet direkt, men skapar en instans av en klass som ärver IDataRecord. Vanligtvis gör du detta genom att hämta en DataReader via ExecuteReader -metoden för Command objektet.

Klasser som ärver IDataRecord måste implementera alla ärvda medlemmar och vanligtvis definiera ytterligare medlemmar för att lägga till providerspecifika funktioner.

Leverantörer som implementerar en DataReader måste exponera data i clr-typer (common language runtime). Typtvång definieras för vissa typer som inte ingår i CLR. Dessa värden kan kommas åt som alternativa typer som följer CLR-typer. I följande tabell visas till exempel föreslagna mappningar från OLE DB-datatyper till CLR-typer, med alternativa typer inom parenteser.