IDataReader Gränssnitt

Definition

public interface class IDataReader : IDisposable, System::Data::IDataRecord

public interface IDataReader : IDisposable, System.Data.IDataRecord

type IDataReader = interface
    interface IDisposable
    interface IDataRecord

type IDataReader = interface
    interface IDataRecord
    interface IDisposable

Public Interface IDataReader
Implements IDataRecord, IDisposable

Härledda

System.Data.Common.DbDataReader

System.Data.Odbc.OdbcDataReader

System.Data.OleDb.OleDbDataReader

System.Data.OracleClient.OracleDataReader

System.Data.SqlClient.SqlDataReader

Implementeringar

IDataRecord IDisposable

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 tillåter att en ärvande klass implementerar en DataReader klass, vilket ger ett sätt att läsa en eller flera framåtriktade strömmar av 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 IDataReader gränssnittet direkt, men skapar en instans av en klass som ärver IDataReader.

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

Ändringar som görs i en resultatuppsättning av en annan process eller tråd medan data läss kan vara synliga för användaren av en klass som implementerar en IDataReader. Det exakta beteendet är dock både provider- och tidsberoende.

Anteckningar till implementerare

För att främja konsekvens mellan .NET Framework-dataprovidrar namnger du ärvningsklassen i formuläret Prv Kommando där Prv är det enhetliga prefixet som ges till alla klasser i ett specifikt .NET Framework-dataprovidernamnområde. Är till exempel Sql prefixet för SqlDataAdapter klassen i System.Data.SqlClient namnområdet.

Användare skapar inte en instans av en DataReader klass direkt. I stället hämtar de instansen DataReaderExecuteReader via -metoden för Command objektet. Därför bör du markera DataReader konstruktorer som interna.