Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

IDataReader-Schnittstelle

 

Veröffentlicht: Juli 2016

Ermöglicht das Lesen eines oder mehrerer Vorwärtsdatenströme von Resultsets, die durch Ausführen eines Befehls für eine Datenquelle abgerufen wurden, und wird von .NET Framework-Datenanbietern implementiert, die auf relationale Datenbanken zugreifen.

Namespace:   System.Data
Assembly:  System.Data (in System.Data.dll)

public interface IDataReader : IDisposable, IDataRecord

NameBeschreibung
System_CAPS_pubpropertyDepth

Ruft einen Wert ab, der die Tiefe der Schachtelung für die aktuelle Zeile angibt.

System_CAPS_pubpropertyFieldCount

Ruft die Anzahl der Spalten in der aktuellen Zeile ab.(Geerbt von „IDataRecord“.)

System_CAPS_pubpropertyIsClosed

Ruft einen Wert ab, der angibt, ob der Datenreader geschlossen ist.

System_CAPS_pubpropertyItem[Int32]

Ruft die Spalte ab, die sich am angegebenen Index befindet.(Geerbt von „IDataRecord“.)

System_CAPS_pubpropertyItem[String]

Ruft die Spalte mit dem angegebenen Namen ab.(Geerbt von „IDataRecord“.)

System_CAPS_pubpropertyRecordsAffected

Ruft die Anzahl der durch die Ausführung der SQL-Anweisung geänderten, eingefügten oder gelöschten Zeilen ab.

NameBeschreibung
System_CAPS_pubmethodClose()

Schließt das IDataReader-Objekt.

System_CAPS_pubmethodDispose()

Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen.(Geerbt von „IDisposable“.)

System_CAPS_pubmethodGetBoolean(Int32)

Ruft den Wert der angegebenen Spalte als booleschen Wert ab.(Geerbt von „IDataRecord“.)

System_CAPS_pubmethodGetByte(Int32)

Ruft den 8-Bit-Ganzzahlwert ohne Vorzeichen der angegebenen Spalte ab.(Geerbt von „IDataRecord“.)

System_CAPS_pubmethodGetBytes(Int32, Int64, Byte[], Int32, Int32)

Liest einen Datenstrom aus dem angegebenen Spaltenoffset als Array in den Puffer, beginnend am angegebenen Pufferoffset.(Geerbt von „IDataRecord“.)

System_CAPS_pubmethodGetChar(Int32)

Ruft den Zeichenwert der angegebenen Spalte ab.(Geerbt von „IDataRecord“.)

System_CAPS_pubmethodGetChars(Int32, Int64, Char[], Int32, Int32)

Liest einen Zeichendatenstrom aus dem angegebenen Spaltenoffset als Array in den Puffer, beginnend am angegebenen Pufferoffset.(Geerbt von „IDataRecord“.)

System_CAPS_pubmethodGetData(Int32)

Gibt einen IDataReader für die angegebene Spaltenordnungszahl zurück.(Geerbt von „IDataRecord“.)

System_CAPS_pubmethodGetDataTypeName(Int32)

Ruft die Datentypinformationen für das angegebene Feld ab.(Geerbt von „IDataRecord“.)

System_CAPS_pubmethodGetDateTime(Int32)

Ruft das Datum und die Uhrzeit des angegebenen Felds ab.(Geerbt von „IDataRecord“.)

System_CAPS_pubmethodGetDecimal(Int32)

Ruft den an fester Position befindlichen numerischen Wert des angegebenen Felds ab.(Geerbt von „IDataRecord“.)

System_CAPS_pubmethodGetDouble(Int32)

Ruft den Wert des angegebenen Felds als Gleitkommazahl mit doppelter Genauigkeit ab.(Geerbt von „IDataRecord“.)

System_CAPS_pubmethodGetFieldType(Int32)

Ruft die Type-Informationen entsprechend dem Typ von Object ab, die von GetValue zurückgegeben würden.(Geerbt von „IDataRecord“.)

System_CAPS_pubmethodGetFloat(Int32)

Ruft den Wert des angegebenen Felds als Gleitkommazahl mit einfacher Genauigkeit ab.(Geerbt von „IDataRecord“.)

System_CAPS_pubmethodGetGuid(Int32)

Gibt den GUID-Wert des angegebenen Felds zurück.(Geerbt von „IDataRecord“.)

System_CAPS_pubmethodGetInt16(Int32)

Ruft den 16-Bit-Ganzzahlwert mit Vorzeichen des angegebenen Felds ab.(Geerbt von „IDataRecord“.)

System_CAPS_pubmethodGetInt32(Int32)

Ruft den 32-Bit-Ganzzahl-mit-Vorzeichen-Wert des angegebenen Felds ab.(Geerbt von „IDataRecord“.)

System_CAPS_pubmethodGetInt64(Int32)

Ruft den 64-Bit-Ganzzahlwert mit Vorzeichen des angegebenen Felds ab.(Geerbt von „IDataRecord“.)

System_CAPS_pubmethodGetName(Int32)

Ruft den Namen des zu suchenden Felds ab.(Geerbt von „IDataRecord“.)

System_CAPS_pubmethodGetOrdinal(String)

Gibt den Index des benannten Felds zurück.(Geerbt von „IDataRecord“.)

System_CAPS_pubmethodGetSchemaTable()

Gibt eine DataTable zurück, die die Spaltenmetadaten des IDataReader beschreibt.

System_CAPS_pubmethodGetString(Int32)

Ruft den Zeichenfolgenwert des angegebenen Felds ab.(Geerbt von „IDataRecord“.)

System_CAPS_pubmethodGetValue(Int32)

Gibt den Wert des angegebenen Felds zurück.(Geerbt von „IDataRecord“.)

System_CAPS_pubmethodGetValues(Object[])

Füllt ein Array von Objekten mit den Spaltenwerten des aktuellen Datensatzes.(Geerbt von „IDataRecord“.)

System_CAPS_pubmethodIsDBNull(Int32)

Gibt zurück, ob das angegebene Feld auf NULL festgelegt ist.(Geerbt von „IDataRecord“.)

System_CAPS_pubmethodNextResult()

Setzt den Datenleser beim Lesen der Ergebnisse von SQL-Anweisungen auf das nächste Ergebnis.

System_CAPS_pubmethodRead()

Setzt den IDataReader auf den nächsten Datensatz.

Die IDataReader und IDataRecord Schnittstellen ermöglichen einer erbenden Klasse zum Implementieren einer DataReader Klasse, die Möglichkeit, lesen eine oder mehrere vorwärtsströme von Resultsets bereitstellt. Weitere Informationen über DataReader-Klassen finden Sie unter Abrufen von Daten mit einem DataReader.

Eine Anwendung erstellt eine Instanz der nicht der IDataReader -Schnittstelle direkt, sondern erstellt eine Instanz einer Klasse, die erbt IDataReader.

Klassen, erben IDataReader müssen Sie die geerbten Member implementieren und definieren Sie in der Regel zusätzliche Elemente, um die anbieterspezifische Funktionalität hinzufügen.

Änderungen an einem Resultset ein weiteres verarbeiten oder thread während des Lesens Daten möglicherweise sichtbar für den Benutzer einer Klasse, die implementiert eine IDataReader. Das genaue Verhalten ist jedoch, Anbieter und Zeitpunkt abhängig.

Hinweise für Implementierer:

Zur Förderung der Konsistenz zwischen .NET Framework-Datenanbieter, benennen Sie die erbende Klasse in der Form Prv Befehl, wobei Prv ist die einheitliche Präfix für alle Klassen in einem bestimmten .NET Framework Data Provider-Namespace. Beispielsweise Sql ist das Präfix des der SqlDataAdapter -Klasse in der System.Data.SqlClient Namespace.

Benutzer erstellen keine Instanz von einem DataReader -Klasse direkt verwendet. Rufen sie stattdessen die DataReader -Instanz über die ExecuteReader Methode der Command Objekt. Aus diesem Grund sollten Sie markieren DataReader Konstruktoren als intern.

Das folgende Beispiel erstellt Instanzen der abgeleiteten Klassen SqlConnection, SqlCommand, und SqlDataReader. Das Beispiel liest durch die Daten, die an die Konsole schreiben. Im Beispiel wird schließlich schließt die SqlDataReader, und klicken Sie dann die SqlConnection.

using System;
using System.Data;
using System.Data.SqlClient;


class Program
{
    static void Main()
    {
        string str = "Data Source=(local);Initial Catalog=Northwind;"
            + "Integrated Security=SSPI";
        ReadOrderData(str);
    }

    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 record)
    {
        Console.WriteLine(String.Format("{0}, {1}", record[0], record[1]));
    }

}

.NET Framework
Verfügbar seit 1.1
Zurück zum Anfang
Anzeigen: