DataTableReader Klasse

Definition

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Assembly:

System.Data.dll

Assembly:

netstandard.dll

Der DataTableReader ruft den Inhalt eines oder mehrerer DataTable-Objekte in Form eines oder mehrerer schreibgeschützter vorwärts gerichteter 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

Object

MarshalByRefObject

DbDataReader

DataTableReader

Hinweise

Dies DataTableReader funktioniert ähnlich wie jeder andere Datenleser, wie z. B. der SqlDataReader, außer dass die DataTableReader Iterierung über Zeilen in einer DataTable. Mit anderen Worten: Sie ermöglicht das Durchlaufen von Zeilen in einem Cache. Die zwischengespeicherten Daten können während der DataTableReader Aktiven geändert werden, und der Leser behält seine Position automatisch bei.

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

Der zurückgegebene Resultset enthält nur die aktuelle Version der einzelnen DataRowZeilen, die zum Löschen markiert sind, werden übersprungen.

Dies stellt einen stabilen Iterator bereit. Das DataTableReader heißt, der Inhalt des DataTableReader Objekts wird nicht ungültig, wenn die Größe der zugrunde liegenden Auflistung während der Iteration geändert wird. Wenn z. B. eine oder mehrere Zeilen in der Auflistung während der Rows Iteration gelöscht oder entfernt werden, wird die aktuelle Position innerhalb der DataTableReader Auflistung entsprechend beibehalten und der Iterator nicht ungültig.

Konstruktoren

DataTableReader(DataTable)	Initialisiert unter Verwendung von Daten aus der bereitgestellten DataTableReader eine neue Instanz der DataTable-Klasse.
DataTableReader(DataTable[])	Initialisiert eine neue Instanz der DataTableReader-Klasse unter Verwendung des bereitgestellten Arrays von DataTable-Objekten.

Eigenschaften

Depth	Die Tiefe der Schachtelung für die aktuelle Zeile des DataTableReader.
FieldCount	Gibt die Anzahl der Spalten in der aktuellen Zeile zurück.
HasRows	Ruft einen Wert ab, der angibt, ob DataTableReader eine oder mehrere Zeilen enthält.
IsClosed	Ruft einen Wert ab, der angibt, ob der DataTableReader synchronisiert ist.
Item[Int32]	Ruft bei angegebener Spaltenordnungszahl den Wert der angegebenen Spalte im systemeigenen Format ab.
Item[String]	Ruft bei angegebenem Spaltennamen den Wert der angegebenen Spalte im systemeigenen Format ab.
RecordsAffected	Ruft die Anzahl der durch die Ausführung der SQL-Anweisung eingefügten, geänderten oder gelöschten Zeilen ab.
VisibleFieldCount	Ruft die Anzahl der nicht ausgeblendeten Felder im DbDataReader ab. (Geerbt von DbDataReader)

Methoden

Close()	Schließt den aktuellen DataTableReader.
CloseAsync()	Schließt das DbDataReader-Objekt asynchron (Geerbt von DbDataReader)
CreateObjRef(Type)	Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject)
Dispose()	Gibt alle von der aktuellen Instanz der DbDataReader-Klasse verwendeten Ressourcen frei. (Geerbt von DbDataReader)
Dispose(Boolean)	Gibt die von DbDataReader verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Geerbt von DbDataReader)
DisposeAsync()	Gibt alle von der aktuellen Instanz der DbDataReader-Klasse verwendeten Ressourcen asynchron frei. (Geerbt von DbDataReader)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetBoolean(Int32)	Ruft den Wert der angegebenen Spalte als Boolean ab.
GetByte(Int32)	Ruft den Wert der angegebenen Spalte als ein Byte ab.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Liest beginnend am jeweiligen Pufferoffset einen Stream von Bytes aus dem angegebenen Spaltenoffset als Array in den Puffer.
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 entsprechenden Implementierung überschreiben. Das cancellationToken kann optional berücksichtigt werden. Die Standardimplementierung ruft den asynchronen GetColumnSchema(DbDataReader)-Aufruf auf und gibt eine abgeschlossene Aufgabe zurück. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen cancellationToken erhalten wird. Die Ausnahmen, die von GetColumnSchema(DbDataReader) ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt. (Geerbt von DbDataReader)
GetData(Int32)	Gibt einen verschachtelten Datenreader 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 Spaltenordnungszahl zurück, das mit einer anbieterspezifischen Implementierung überschrieben werden kann. (Geerbt von DbDataReader)
GetDecimal(Int32)	Ruft den Wert der angegebenen Spalte als Decimal ab.
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 den Type ab, der den Datentyp des Objekts darstellt.
GetFieldValue<T>(Int32)	Ruft den Wert der angegebenen Spalte als angeforderten Typ ab. (Geerbt von DbDataReader)
GetFieldValueAsync<T>(Int32)	Ruft den Wert der angegebenen Spalte asynchron als angeforderten Typ ab. (Geerbt von DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)	Ruft den Wert der angegebenen Spalte asynchron 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 global eindeutigen Bezeichner (Globally Unique Identifier, GUID) ab.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetInt16(Int32)	Ruft den Wert der angegebenen Spalte als 16-Bit-Ganzzahl mit Vorzeichen ab.
GetInt32(Int32)	Ruft den Wert der angegebenen Spalte als ganze Zahl mit Vorzeichen und einer Länge von 32 Bit ab.
GetInt64(Int32)	Ruft den Wert der angegebenen Spalte als 64-Bit-Ganzzahl mit Vorzeichen ab.
GetLifetimeService()	Veraltet. Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetName(Int32)	Ruft den Wert der angegebenen Spalte als String ab.
GetOrdinal(String)	Ruft bei angegebenem Spaltennamen die Ordnungszahl der Spalte ab.
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 DataTableReader auf.
GetSchemaTable()	Gibt eine DataTable zurück, die die Spaltenmetadaten des DataTableReader beschreibt.
GetSchemaTableAsync(CancellationToken)	Dies ist die asynchrone Version von GetSchemaTable(). Anbieter sollten mit einer entsprechenden Implementierung überschreiben. Das cancellationToken kann optional berücksichtigt werden. Die Standardimplementierung ruft den asynchronen GetSchemaTable()-Aufruf auf und gibt eine abgeschlossene Aufgabe zurück. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen cancellationToken erhalten wird. Die Ausnahmen, die von GetSchemaTable() ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt. (Geerbt von DbDataReader)
GetStream(Int32)	Ruft einen Stream ab, um Daten aus der angegebenen Spalte abzurufen. (Geerbt von DbDataReader)
GetString(Int32)	Ruft den Wert der angegebenen Spalte als eine Zeichenfolge ab.
GetTextReader(Int32)	Ruft einen Textreader zum Auslesen von Daten aus der Spalte ab. (Geerbt von DbDataReader)
GetType()	Ruft den 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 zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject)
IsDBNull(Int32)	Ruft einen Wert ab, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält.
IsDBNullAsync(Int32)	Ruft asynchron einen Wert ab, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält. (Geerbt von DbDataReader)
IsDBNullAsync(Int32, CancellationToken)	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 des aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject)
NextResult()	Setzt den DataTableReader auf das nächste Resultset, sofern vorhanden.
NextResultAsync()	Setzt den Datenreader beim Lesen der Ergebnisse von Batchanweisungen asynchron auf das nächste Ergebnis. (Geerbt von DbDataReader)
NextResultAsync(CancellationToken)	Setzt den Datenreader beim Lesen der Ergebnisse von Batchanweisungen asynchron auf das nächste Ergebnis. (Geerbt von DbDataReader)
Read()	Setzt den DataTableReader auf den nächsten Datensatz.
ReadAsync()	Setzt den Reader asynchron auf den nächsten Datensatz in einem Resultset. (Geerbt von DbDataReader)
ReadAsync(CancellationToken)	Setzt den Reader asynchron auf den 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 Elements finden Sie unter GetData(Int32). (Geerbt von DbDataReader)

Erweiterungsmethoden

CanGetColumnSchema(DbDataReader)	Ruft einen Wert ab, der angibt, ob ein DbDataReader-Objekt ein Spaltenschema haben kann.
GetColumnSchema(DbDataReader)	Ruft das Spaltenschema für ein DbDataReader-Objekt ab (DbColumn-Auflistung).
GetBoolean(DbDataReader, String)	Ruft den Wert der angegebenen Spalte als booleschen Wert ab.
GetByte(DbDataReader, String)	Ruft den Wert der angegebenen Spalte als ein Byte ab.
GetBytes(DbDataReader, String, Int64, Byte[], Int32, Int32)	Liest eine angegebene Anzahl Bytes, beginnend bei einem angegebenen Index, aus der angegebenen Spalte und schreibt sie, beginnend bei einer angegebenen Position, in einen Puffer.
GetChar(DbDataReader, String)	Ruft den Wert der angegebenen Spalte als Einzelzeichen ab.
GetChars(DbDataReader, String, Int64, Char[], Int32, Int32)	Liest eine angegebene Anzahl Zeichen, beginnend bei einem angegebenen Index, aus der angegebenen Spalte und schreibt sie, beginnend bei einer angegebenen Position, in einen Puffer.
GetData(DbDataReader, String)	Gibt einen verschachtelten Datenreader 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 Decimal ab.
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 den Wert der angegebenen Spalte asynchron 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 GUID (Globally Unique Identifier) ab.
GetInt16(DbDataReader, String)	Ruft den Wert der angegebenen Spalte als 16-Bit-Ganzzahl mit Vorzeichen ab.
GetInt32(DbDataReader, String)	Ruft den Wert der angegebenen Spalte als ganze Zahl mit Vorzeichen und einer Länge von 32 Bit ab.
GetInt64(DbDataReader, String)	Ruft den Wert der angegebenen Spalte als 64-Bit-Ganzzahl mit Vorzeichen 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 Stream ab, um Daten aus der angegebenen Spalte abzurufen.
GetString(DbDataReader, String)	Ruft den Wert der angegebenen Spalte als eine Instanz von String ab.
GetTextReader(DbDataReader, String)	Ruft einen Textreader zum Auslesen von Daten aus der Spalte ab.
GetValue(DbDataReader, String)	Ruft den Wert der angegebenen Spalte als eine Instanz von Object ab.
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 eines IEnumerable anhand eines angegebenen Typs
AsParallel(IEnumerable)	Ermöglicht die Parallelisierung einer Abfrage.
AsQueryable(IEnumerable)	Konvertiert einen IEnumerable in einen IQueryable.
ConfigureAwait(IAsyncDisposable, Boolean)	Konfiguriert, wie Wartezeiten auf die Aufgaben angewandt werden, die von einem asynchronen verwerfbaren Element zurückgegeben werden.