IDataReader Schnittstelle

Definition

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

public interface IDataReader : IDisposable, System.Data.IDataRecord

type IDataReader = interface
    interface IDataRecord
    interface IDisposable

type IDataReader = interface
    interface IDisposable
    interface IDataRecord

Public Interface IDataReader
Implements IDataRecord, IDisposable

Abgeleitet

System.Data.Common.DbDataReader

System.Data.Odbc.OdbcDataReader

System.Data.OleDb.OleDbDataReader

System.Data.OracleClient.OracleDataReader

System.Data.SqlClient.SqlDataReader

Implementiert

IDataRecord IDisposable

Beispiele

Im folgenden Beispiel werden Instanzen der abgeleiteten Klassen SqlConnection, SqlCommandund SqlDataReadererstellt. Im Beispiel werden die Daten gelesen und in die Konsole geschrieben. Schließlich schließt das Beispiel die SqlDataReader- und dann die 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

Hinweise

Die IDataReader Schnittstellen und IDataRecord ermöglichen es einer erbenden Klasse, eine DataReader Klasse zu implementieren, die eine Möglichkeit zum Lesen eines oder mehrerer Forward-Only-Datenströme von Resultsets bietet. Weitere Informationen zu DataReader Klassen finden Sie unter Abrufen von Daten mithilfe eines DataReader.

Eine Anwendung erstellt nicht direkt einen instance der IDataReader Schnittstelle, sondern erstellt eine instance einer Klasse, die erbtIDataReader.

Klassen, die erben IDataReader , müssen die geerbten Member implementieren und in der Regel zusätzliche Member definieren, um anbieterspezifische Funktionen hinzuzufügen.

Änderungen, die von einem anderen Prozess oder Thread an einem Resultset vorgenommen werden, während Daten gelesen werden, können für den Benutzer einer Klasse sichtbar sein, die eine IDataReaderimplementiert. Das genaue Verhalten ist jedoch sowohl vom Anbieter als auch vom Zeitpunkt abhängig.

Hinweise für Ausführende

Um die Konsistenz zwischen .NET Framework Datenanbietern zu fördern, benennen Sie die erbende Klasse im Format Prv Command, wobei Prv das einheitliche Präfix ist, das allen Klassen in einem bestimmten .NET Framework-Datenanbieternamespace zugewiesen wird. Sql Beispielsweise ist das Präfix der SqlDataAdapter -Klasse im System.Data.SqlClient Namespace.

Benutzer erstellen keine instance einer DataReader Klasse direkt. Stattdessen erhalten sie die DataReader instance über die ExecuteReader -Methode des Command -Objekts. Daher sollten Sie Konstruktoren als intern markieren DataReader .

Eigenschaften

Methoden

Gilt für: