DataTableReader Klasse

Definition

Die DataTableReader ruft den Inhalt eines oder mehrerer DataTable Objekte in Form eines oder mehrerer schreibgeschützter, vorwärtsgeschützter Resultsets ab.

public ref class DataTableReader sealed : System::Data::Common::DbDataReader
public sealed class DataTableReader : System.Data.Common.DbDataReader
type DataTableReader = class
    inherit DbDataReader
Public NotInheritable Class DataTableReader
Inherits DbDataReader
Vererbung

Hinweise

Die DataTableReader funktioniert ähnlich wie jeder andere Datenleser, z. B. die SqlDataReader, mit der Ausnahme, dass die DataTableReader das Durchlaufen von Zeilen in einem DataTableermöglicht. Mit anderen Worten: Sie ermöglicht das Durchlaufen von Zeilen in einem Cache. Die zwischengespeicherten Daten können geändert werden, während die DataTableReader aktiv ist, und der Leser behält seine Position automatisch bei.

Wenn Sie eine DataTableReader aus einem DataTableerstellen, enthält das resultierende DataTableReader-Objekt ein Resultset mit denselben Daten wie die DataTable, aus der sie erstellt wurde, mit Ausnahme aller Zeilen, die als gelöscht markiert wurden. Die Spalten werden in der gleichen Reihenfolge wie im ursprünglichen DataTableangezeigt. Die Struktur des zurückgegebenen Ergebnisses ist in Schema und Daten mit dem ursprünglichen DataTableidentisch. Eine DataTableReader, die durch Aufrufen der CreateDataReader-Methode eines DataSet-Objekts erstellt wurde, enthält mehrere Resultsets, wenn die DataSet mehrere Tabellen enthält. Die Ergebnisse sind in der gleichen Reihenfolge wie die DataTable Objekte im DataTableCollection des DataSet Objekts.

Das zurückgegebene Resultset enthält nur die aktuelle Version jeder DataRow; Zeilen, die für den Löschvorgang markiert sind, werden übersprungen.

Die DataTableReader bietet einen stabilen Iterator; d. h. der Inhalt der DataTableReader wird nicht ungültig, wenn die Größe der zugrunde liegenden Auflistung während der Iteration geändert wird. Wenn beispielsweise eine oder mehrere Zeilen in der Rows Auflistung während der Iteration gelöscht oder entfernt werden, wird die aktuelle Position innerhalb der DataTableReader entsprechend beibehalten und der Iterator nicht ungültig.

Konstruktoren

DataTableReader(DataTable)

Initialisiert eine neue Instanz der DataTableReader Klasse mithilfe von Daten aus der bereitgestellten DataTable.

DataTableReader(DataTable[])

Initialisiert eine neue Instanz der DataTableReader Klasse mithilfe des bereitgestellten Arrays von DataTable-Objekten.

Eigenschaften

Depth

Die Tiefe der Schachtelung für die aktuelle Zeile der DataTableReader.

FieldCount

Gibt die Anzahl der Spalten in der aktuellen Zeile zurück.

HasRows

Ruft einen Wert ab, der angibt, ob die DataTableReader eine oder mehrere Zeilen enthält.

IsClosed

Ruft einen Wert ab, der angibt, ob die DataTableReader geschlossen ist.

Item[Int32]

Ruft den Wert der angegebenen Spalte im systemeigenen Format ab, wenn die Spalte Ordnungszahl angegeben ist.

Item[String]

Ruft den Wert der angegebenen Spalte im systemeigenen Format ab, das den Spaltennamen enthält.

RecordsAffected

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

VisibleFieldCount

Ruft die Anzahl der Felder in der DbDataReader ab, die nicht ausgeblendet sind.

(Geerbt von DbDataReader)

Methoden

Close()

Schließt die aktuelle DataTableReader.

CloseAsync()

Schließt das DbDataReader-Objekt asynchron.

(Geerbt von DbDataReader)
CreateObjRef(Type)

Erstellt ein Objekt, das alle relevanten Informationen enthält, die zum Generieren eines Proxys erforderlich sind, der für die Kommunikation mit einem Remoteobjekt verwendet wird.

(Geerbt von MarshalByRefObject)
Dispose()

Gibt alle Ressourcen frei, die von der aktuellen Instanz der DbDataReader Klasse verwendet werden.

(Geerbt von DbDataReader)
Dispose(Boolean)

Gibt die nicht verwalteten Ressourcen frei, die vom DbDataReader verwendet werden, und gibt optional die verwalteten Ressourcen frei.

(Geerbt von DbDataReader)
DisposeAsync()

Gibt asynchron alle Ressourcen frei, die von der aktuellen Instanz der DbDataReader Klasse verwendet werden.

(Geerbt von DbDataReader)
Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
GetBoolean(Int32)

Ruft den Wert der angegebenen Spalte als Booleanab.

GetByte(Int32)

Ruft den Wert der angegebenen Spalte als Byte ab.

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

Liest einen Bytestrom ab dem angegebenen Spaltenoffset in den Puffer als Array ab dem angegebenen Pufferoffset.

GetChar(Int32)

Ruft den Wert der angegebenen Spalte als Zeichen ab.

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

Gibt den Wert der angegebenen Spalte als Zeichenarray zurück.

GetColumnSchemaAsync(CancellationToken)

Dies ist die asynchrone Version von GetColumnSchema(DbDataReader). Anbieter sollten mit einer geeigneten Implementierung außer Kraft setzen. Die cancellationToken können optional berücksichtigt werden. Die Standardimplementierung ruft den synchronen GetColumnSchema(DbDataReader) Aufruf auf und gibt eine abgeschlossene Aufgabe zurück. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn eine bereits abgebrochene cancellationTokenübergeben wurde. Ausnahmen, die von GetColumnSchema(DbDataReader) ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft kommuniziert.

(Geerbt von DbDataReader)
GetData(Int32)

Gibt einen geschachtelten Datenleser für die angeforderte Spalte zurück.

(Geerbt von DbDataReader)
GetDataTypeName(Int32)

Ruft eine Zeichenfolge ab, die den Datentyp der angegebenen Spalte darstellt.

GetDateTime(Int32)

Ruft den Wert der angegebenen Spalte als DateTime -Objekt ab.

GetDbDataReader(Int32)

Gibt ein DbDataReader -Objekt für die angeforderte Spalten-Ordnungszahl zurück, die mit einer anbieterspezifischen Implementierung überschrieben werden kann.

(Geerbt von DbDataReader)
GetDecimal(Int32)

Ruft den Wert der angegebenen Spalte als Decimalab.

GetDouble(Int32)

Ruft den Wert der Spalte als Gleitkommazahl mit doppelter Genauigkeit ab.

GetEnumerator()

Gibt einen Enumerator zurück, der zum Durchlaufen der Elementauflistung verwendet werden kann.

GetFieldType(Int32)

Ruft die Type ab, die der Datentyp des Objekts ist.

GetFieldValue<T>(Int32)

Ruft den Wert der angegebenen Spalte als angeforderten Typ ab.

(Geerbt von DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)

Ruft asynchron den Wert der angegebenen Spalte als angeforderten Typ ab.

(Geerbt von DbDataReader)
GetFieldValueAsync<T>(Int32)

Ruft asynchron den Wert der angegebenen Spalte als angeforderten Typ ab.

(Geerbt von DbDataReader)
GetFloat(Int32)

Ruft den Wert der angegebenen Spalte als Gleitkommazahl mit einfacher Genauigkeit ab.

GetGuid(Int32)

Ruft den Wert der angegebenen Spalte als GUID (Globally Unique Identifier) ab.

GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetInt16(Int32)

Ruft den Wert der angegebenen Spalte als eine 16-Bit-ganzzahlige Vorzeichen ab.

GetInt32(Int32)

Ruft den Wert der angegebenen Spalte als 32-Bit-ganzzahlige Vorzeichen ab.

GetInt64(Int32)

Ruft den Wert der angegebenen Spalte als ganze 64-Bit-Ganzzahl ab.

GetLifetimeService()
Veraltet.

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinie für diese Instanz steuert.

(Geerbt von MarshalByRefObject)
GetName(Int32)

Ruft den Wert der angegebenen Spalte als Stringab.

GetOrdinal(String)

Ruft die Spalten-Ordnungszahl ab, wobei der Name der Spalte angegeben ist.

GetProviderSpecificFieldType(Int32)

Ruft den Typ der angegebenen Spalte im anbieterspezifischen Format ab.

GetProviderSpecificValue(Int32)

Ruft den Wert der angegebenen Spalte im anbieterspezifischen Format ab.

GetProviderSpecificValues(Object[])

Füllt das angegebene Array mit anbieterspezifischen Typinformationen für alle Spalten im DataTableReaderaus.

GetSchemaTable()

Gibt einen DataTable zurück, der die Spaltenmetadaten des DataTableReaderbeschreibt.

GetSchemaTableAsync(CancellationToken)

Dies ist die asynchrone Version von GetSchemaTable(). Anbieter sollten mit einer geeigneten Implementierung außer Kraft setzen. Die cancellationToken können optional berücksichtigt werden. Die Standardimplementierung ruft den synchronen GetSchemaTable() Aufruf auf und gibt eine abgeschlossene Aufgabe zurück. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn eine bereits abgebrochene cancellationTokenübergeben wurde. Ausnahmen, die von GetSchemaTable() ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft kommuniziert.

(Geerbt von DbDataReader)
GetStream(Int32)

Ruft einen Datenstrom ab, um Daten aus der angegebenen Spalte abzurufen.

(Geerbt von DbDataReader)
GetString(Int32)

Ruft den Wert der angegebenen Spalte als Zeichenfolge ab.

GetTextReader(Int32)

Ruft einen Textleser ab, um Daten aus der Spalte abzurufen.

(Geerbt von DbDataReader)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
GetValue(Int32)

Ruft den Wert der angegebenen Spalte im systemeigenen Format ab.

GetValues(Object[])

Füllt ein Array von Objekten mit den Spaltenwerten der aktuellen Zeile auf.

InitializeLifetimeService()
Veraltet.

Ruft ein Lebensdauerdienstobjekt ab, um die Lebensdauerrichtlinie für diese Instanz zu steuern.

(Geerbt von MarshalByRefObject)
IsDBNull(Int32)

Ruft einen Wert ab, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält.

IsDBNullAsync(Int32, CancellationToken)

Ruft asynchron einen Wert ab, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält.

(Geerbt von DbDataReader)
IsDBNullAsync(Int32)

Ruft asynchron einen Wert ab, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält.

(Geerbt von DbDataReader)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.

(Geerbt von MarshalByRefObject)
NextResult()

Wechselt die DataTableReader zum nächsten Resultset, falls vorhanden.

NextResultAsync()

Wechselt den Leser asynchron zum nächsten Ergebnis, wenn die Ergebnisse einer Reihe von Anweisungen gelesen werden.

(Geerbt von DbDataReader)
NextResultAsync(CancellationToken)

Wechselt den Leser asynchron zum nächsten Ergebnis, wenn die Ergebnisse einer Reihe von Anweisungen gelesen werden.

(Geerbt von DbDataReader)
Read()

Wechselt die DataTableReader zum nächsten Datensatz.

ReadAsync()

Wechselt den Leser asynchron zum nächsten Datensatz in einem Resultset.

(Geerbt von DbDataReader)
ReadAsync(CancellationToken)

Wechselt den Leser asynchron zum nächsten Datensatz in einem Resultset.

(Geerbt von DbDataReader)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

IDataRecord.GetData(Int32)

Eine Beschreibung dieses Mitglieds finden Sie unter GetData(Int32).

(Geerbt von DbDataReader)

Erweiterungsmethoden

CanGetColumnSchema(DbDataReader)

Ruft einen Wert ab, der angibt, ob ein DbDataReader ein Spaltenschema abrufen kann.

GetColumnSchema(DbDataReader)

Ruft das Spaltenschema (DbColumn -Auflistung) für eine DbDataReaderab.

GetBoolean(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als booleschen Wert ab.

GetByte(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als Byte ab.

GetBytes(DbDataReader, String, Int64, Byte[], Int32, Int32)

Liest eine angegebene Anzahl von Bytes aus der angegebenen Spalte beginnend mit einem angegebenen Index und schreibt sie in einen Puffer, der an einer angegebenen Position im Puffer beginnt.

GetChar(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als einzelnes Zeichen ab.

GetChars(DbDataReader, String, Int64, Char[], Int32, Int32)

Liest eine angegebene Anzahl von Zeichen aus einer angegebenen Spalte ab einem angegebenen Index und schreibt sie in einen Puffer, der an einer angegebenen Position beginnt.

GetData(DbDataReader, String)

Gibt einen geschachtelten Datenleser für die angeforderte Spalte zurück.

GetDataTypeName(DbDataReader, String)

Ruft den Namen des Datentyps der angegebenen Spalte ab.

GetDateTime(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als DateTime -Objekt ab.

GetDecimal(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als Decimalab.

GetDouble(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als Gleitkommazahl mit doppelter Genauigkeit ab.

GetFieldType(DbDataReader, String)

Ruft den Datentyp der angegebenen Spalte ab.

GetFieldValue<T>(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als angeforderten Typ ab.

GetFieldValueAsync<T>(DbDataReader, String, CancellationToken)

Ruft asynchron den Wert der angegebenen Spalte als angeforderten Typ ab.

GetFloat(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als Gleitkommazahl mit einfacher Genauigkeit ab.

GetGuid(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als global eindeutigen Bezeichner (GUID) ab.

GetInt16(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als eine 16-Bit-ganzzahlige Vorzeichen ab.

GetInt32(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als 32-Bit-ganzzahlige Vorzeichen ab.

GetInt64(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als ganze 64-Bit-Ganzzahl ab.

GetProviderSpecificFieldType(DbDataReader, String)

Ruft den anbieterspezifischen Typ der angegebenen Spalte ab.

GetProviderSpecificValue(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als Instanz eines anbieterspezifischen Typs ab.

GetStream(DbDataReader, String)

Ruft einen Datenstrom ab, um Daten aus der angegebenen Spalte abzurufen.

GetString(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als Instanz von Stringab.

GetTextReader(DbDataReader, String)

Ruft einen Textleser ab, um Daten aus der Spalte abzurufen.

GetValue(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als Instanz von Objectab.

IsDBNull(DbDataReader, String)

Ruft einen Wert ab, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält.

IsDBNullAsync(DbDataReader, String, CancellationToken)

Ruft asynchron einen Wert ab, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält.

Cast<TResult>(IEnumerable)

Wandelt die Elemente eines IEnumerable in den angegebenen Typ um.

OfType<TResult>(IEnumerable)

Filtert die Elemente einer IEnumerable basierend auf einem angegebenen Typ.

AsParallel(IEnumerable)

Aktiviert die Parallelisierung einer Abfrage.

AsQueryable(IEnumerable)

Wandelt eine IEnumerable in eine IQueryableum.

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguriert, wie auf die von einem asynchronen Einweg zurückgegebenen Aufgaben gewartet wird.

Gilt für: