IDataReader Interface

Definitie

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

Afgeleid

System.Data.Common.DbDataReader

System.Data.Odbc.OdbcDataReader

System.Data.OleDb.OleDbDataReader

System.Data.OracleClient.OracleDataReader

System.Data.SqlClient.SqlDataReader

Implementeringen

IDataRecord IDisposable

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 forward-only streams 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 IDataReader interface rechtstreeks, maar maakt een exemplaar van een klasse die wordt overgenomen IDataReader.

Klassen die overnemen IDataReader , moeten de overgenomen leden implementeren en definiëren doorgaans extra leden om providerspecifieke functionaliteit toe te voegen.

Wijzigingen die zijn aangebracht in een resultatenset door een ander proces of een andere thread terwijl gegevens worden gelezen, zijn mogelijk zichtbaar voor de gebruiker van een klasse die een IDataReaderimplementeert. Het precieze gedrag is echter zowel provider- als timingafhankelijk.

Notities voor uitvoerders

Als u consistentie tussen .NET Framework-gegevensproviders wilt bevorderen, geeft u de overnemende klasse een naam in de vorm Prv Command, waarbij Prv het uniforme voorvoegsel is dat wordt gegeven aan alle klassen in een specifieke .NET Framework-naamruimte voor de gegevensprovider. Is bijvoorbeeld Sql het voorvoegsel van de SqlDataAdapter klasse in de System.Data.SqlClient naamruimte.

Gebruikers maken geen exemplaar van een DataReader klasse rechtstreeks. In plaats daarvan verkrijgen ze het DataReader exemplaar via de ExecuteReader methode van het Command object. Daarom moet u constructors markeren DataReader als intern.