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

DataTableReader-Klasse

 

Veröffentlicht: Oktober 2016

Der DataTableReader ruft den Inhalt eines oder mehrerer DataTable-Objekte in Form eines oder mehrerer schreibgeschützter vorwärts gerichteter Resultsets ab.

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

System.Object
  System.MarshalByRefObject
    System.Data.Common.DbDataReader
      System.Data.DataTableReader

public sealed class DataTableReader : DbDataReader

NameBeschreibung
System_CAPS_pubmethodDataTableReader(DataTable)

Initialisiert eine neue Instanz der DataTableReader -Klasse unter Verwendung von Daten aus dem angegebenen DataTable.

System_CAPS_pubmethodDataTableReader(DataTable[])

Initialisiert eine neue Instanz der DataTableReader -Klasse unter Verwendung des bereitgestellten Arrays von DataTable Objekte.

NameBeschreibung
System_CAPS_pubpropertyDepth

Die Tiefe der Schachtelung für die aktuelle Zeile von der DataTableReader.(Überschreibt DbDataReader.Depth.)

System_CAPS_pubpropertyFieldCount

Gibt die Anzahl der Spalten in der aktuellen Zeile zurück.(Überschreibt DbDataReader.FieldCount.)

System_CAPS_pubpropertyHasRows

Ruft einen Wert, der angibt, ob die DataTableReader eine oder mehrere Zeilen enthält.(Überschreibt DbDataReader.HasRows.)

System_CAPS_pubpropertyIsClosed

Ruft einen Wert, der angibt, ob die DataTableReader geschlossen wird.(Überschreibt DbDataReader.IsClosed.)

System_CAPS_pubpropertyItem[Int32]

Ruft den Wert der angegebenen Spalte im systemeigenen Format Ordnungszahl der Spalte ab.(Überschreibt DbDataReader.Item[Int32].)

System_CAPS_pubpropertyItem[String]

Ruft den Wert der angegebenen Spalte im systemeigenen Format erhält den Namen der Spalte ab.(Überschreibt DbDataReader.Item[String].)

System_CAPS_pubpropertyRecordsAffected

Ruft die Anzahl der Zeilen eingefügt, geändert oder gelöscht werden, durch die Ausführung der SQL-Anweisung ab.(Überschreibt DbDataReader.RecordsAffected.)

System_CAPS_pubpropertyVisibleFieldCount

Ruft die Anzahl der nicht ausgeblendeten Felder im DbDataReader ab.(Geerbt von „DbDataReader“.)

NameBeschreibung
System_CAPS_pubmethodClose()

Schließt das aktuelle DataTableReader.(Überschreibt DbDataReader.Close().)

System_CAPS_pubmethodCreateObjRef(Type)

Erstellt ein Objekt, das alle relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.(Geerbt von „MarshalByRefObject“.)

System_CAPS_pubmethodDispose()

Gibt alle von der aktuellen Instanz der DbDataReader-Klasse verwendeten Ressourcen frei.(Geerbt von „DbDataReader“.)

System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.(Geerbt von „Object“.)

System_CAPS_pubmethodGetBoolean(Int32)

Ruft den Wert der angegebenen Spalte als ein Boolean.(Überschreibt DbDataReader.GetBoolean(Int32).)

System_CAPS_pubmethodGetByte(Int32)

Ruft den Wert der angegebenen Spalte als ein Byte ab.(Überschreibt DbDataReader.GetByte(Int32).)

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

Liest einen Stream von Bytes, die beginnend am angegebenen Spaltenoffset in den Puffer als ein Array, beginnend am angegebenen Pufferoffset.(Überschreibt DbDataReader.GetBytes(Int32, Int64, Byte[], Int32, Int32).)

System_CAPS_pubmethodGetChar(Int32)

Ruft den Wert der angegebenen Spalte als Zeichen ab.(Überschreibt DbDataReader.GetChar(Int32).)

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

Gibt den Wert der angegebenen Spalte als ein Array von Zeichen zurück.(Überschreibt DbDataReader.GetChars(Int32, Int64, Char[], Int32, Int32).)

System_CAPS_pubmethodGetData(Int32)

Gibt ein DbDataReader -Objekt für die angeforderte Spaltenordnungszahl.(Geerbt von „DbDataReader“.)

System_CAPS_pubmethodGetDataTypeName(Int32)

Ruft eine Zeichenfolge, die den Datentyp der angegebenen Spalte darstellt.(Überschreibt DbDataReader.GetDataTypeName(Int32).)

System_CAPS_pubmethodGetDateTime(Int32)

Ruft den Wert der angegebenen Spalte als DateTime-Objekt ab.(Überschreibt DbDataReader.GetDateTime(Int32).)

System_CAPS_pubmethodGetDecimal(Int32)

Ruft den Wert der angegebenen Spalte als ein Decimal.(Überschreibt DbDataReader.GetDecimal(Int32).)

System_CAPS_pubmethodGetDouble(Int32)

Ruft den Wert der Spalte als Gleitkommazahl mit doppelter Genauigkeit ab.(Überschreibt DbDataReader.GetDouble(Int32).)

System_CAPS_pubmethodGetEnumerator()

Gibt einen Enumerator, der zum Durchlaufen der Auflistung verwendet werden kann.(Überschreibt DbDataReader.GetEnumerator().)

System_CAPS_pubmethodGetFieldType(Int32)

Ruft die Type dass der Datentyp des Objekts.(Überschreibt DbDataReader.GetFieldType(Int32).)

System_CAPS_pubmethodGetFieldValue<T>(Int32)

Synchron Ruft den Wert der angegebenen Spalte als Typ.(Geerbt von „DbDataReader“.)

System_CAPS_pubmethodGetFieldValueAsync<T>(Int32)

Ruft den Wert der angegebenen Spalte als Typ.(Geerbt von „DbDataReader“.)

System_CAPS_pubmethodGetFieldValueAsync<T>(Int32, CancellationToken)

Ruft den Wert der angegebenen Spalte als Typ.(Geerbt von „DbDataReader“.)

System_CAPS_pubmethodGetFloat(Int32)

Ruft den Wert der angegebenen Spalte als Gleitkommazahl mit einfacher Genauigkeit ab.(Überschreibt DbDataReader.GetFloat(Int32).)

System_CAPS_pubmethodGetGuid(Int32)

Ruft den Wert der angegebenen Spalte als global eindeutigen Bezeichner (Globally Unique Identifier, GUID) ab.(Überschreibt DbDataReader.GetGuid(Int32).)

System_CAPS_pubmethodGetHashCode()

Fungiert als die Standardhashfunktion.(Geerbt von „Object“.)

System_CAPS_pubmethodGetInt16(Int32)

Ruft den Wert der angegebenen Spalte als eine 16-Bit-Ganzzahl mit Vorzeichen ab.(Überschreibt DbDataReader.GetInt16(Int32).)

System_CAPS_pubmethodGetInt32(Int32)

Ruft den Wert der angegebenen Spalte als eine 32-Bit-Ganzzahl mit Vorzeichen ab.(Überschreibt DbDataReader.GetInt32(Int32).)

System_CAPS_pubmethodGetInt64(Int32)

Ruft den Wert der angegebenen Spalte als 64-Bit-Ganzzahl mit Vorzeichen ab.(Überschreibt DbDataReader.GetInt64(Int32).)

System_CAPS_pubmethodGetLifetimeService()

Ruft die aktuellen Service-Objekt, das die Lebensdauerrichtlinien für diese Instanz steuert.(Geerbt von „MarshalByRefObject“.)

System_CAPS_pubmethodGetName(Int32)

Ruft den Wert der angegebenen Spalte als ein String.(Überschreibt DbDataReader.GetName(Int32).)

System_CAPS_pubmethodGetOrdinal(String)

Ruft die erhält den Namen der Spalte die Spalte Ordinalzahl ab.(Überschreibt DbDataReader.GetOrdinal(String).)

System_CAPS_pubmethodGetProviderSpecificFieldType(Int32)

Ruft den Typ der angegebenen Spalte im anbieterspezifischen Format ab.(Überschreibt DbDataReader.GetProviderSpecificFieldType(Int32).)

System_CAPS_pubmethodGetProviderSpecificValue(Int32)

Ruft den Wert der angegebenen Spalte im anbieterspezifischen Format ab.(Überschreibt DbDataReader.GetProviderSpecificValue(Int32).)

System_CAPS_pubmethodGetProviderSpecificValues(Object[])

Füllt das angegebene Array mit anbieterspezifischen Typinformationen für alle Spalten in der DataTableReader.(Überschreibt DbDataReader.GetProviderSpecificValues(Object[]).)

System_CAPS_pubmethodGetSchemaTable()

Gibt eine DataTable zurück, die die Spaltenmetadaten des DataTableReader beschreibt.(Überschreibt DbDataReader.GetSchemaTable().)

System_CAPS_pubmethodGetStream(Int32)

Ruft die Daten als ein Stream.(Geerbt von „DbDataReader“.)

System_CAPS_pubmethodGetString(Int32)

Ruft den Wert der angegebenen Spalte als Zeichenfolge ab.(Überschreibt DbDataReader.GetString(Int32).)

System_CAPS_pubmethodGetTextReader(Int32)

Ruft die Daten als ein TextReader.(Geerbt von „DbDataReader“.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodGetValue(Int32)

Ruft den Wert der angegebenen Spalte im systemeigenen Format ab.(Überschreibt DbDataReader.GetValue(Int32).)

System_CAPS_pubmethodGetValues(Object[])

Füllt ein Array von Objekten mit den Spaltenwerten der aktuellen Zeile.(Überschreibt DbDataReader.GetValues(Object[]).)

System_CAPS_pubmethodInitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinien für diese Instanz ab.(Geerbt von „MarshalByRefObject“.)

System_CAPS_pubmethodIsDBNull(Int32)

Ruft einen Wert, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält.(Überschreibt DbDataReader.IsDBNull(Int32).)

System_CAPS_pubmethodIsDBNullAsync(Int32)

Eine asynchrone Version der IsDBNull, der einem Wert abruft, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält.(Geerbt von „DbDataReader“.)

System_CAPS_pubmethodIsDBNullAsync(Int32, CancellationToken)

Eine asynchrone Version der IsDBNull, der einem Wert abruft, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält. Optional, sendet eine Benachrichtigung, dass Vorgänge abgebrochen werden soll.(Geerbt von „DbDataReader“.)

System_CAPS_pubmethodNextResult()

Setzt die DataTableReader auf das nächste Resultset, sofern vorhanden.(Überschreibt DbDataReader.NextResult().)

System_CAPS_pubmethodNextResultAsync()

Eine asynchrone Version der NextResult, die verschiebt den Reader zum nächsten Ergebnis beim Lesen der Ergebnisse von Batchanweisungen.

Ruft NextResultAsync mit CancellationToken.None.(Geerbt von „DbDataReader“.)

System_CAPS_pubmethodNextResultAsync(CancellationToken)

Dies ist die asynchrone Version der NextResult. Anbieter sollten durch eine geeignete Implementierung überschreiben. Die cancellationToken kann optional ignoriert werden.

Die standardmäßige Implementierung ruft die synchrone NextResult Methode und gibt eine abgeschlossene Aufgabe, die den aufrufenden Thread zu blockieren. Die standardmäßige Implementierung gibt eine abgebrochene Aufgabe zurück, wenn ein bereits abgebrochen übergeben cancellationToken. Ausgelöste Ausnahmen NextResult Updates werden über die zurückgegebene Ausnahme einer Aufgabe-Eigenschaft.

Andere Methoden und Eigenschaften des Objekts DbDataReader sollte nicht aufgerufen werden, während die zurückgegebene Aufgabe noch nicht abgeschlossen ist.(Geerbt von „DbDataReader“.)

System_CAPS_pubmethodRead()

Setzt den DataTableReader auf den nächsten Datensatz.(Überschreibt DbDataReader.Read().)

System_CAPS_pubmethodReadAsync()

Eine asynchrone Version der Read, die verschiebt den Reader auf den nächsten Datensatz in einem Resultset. Diese Methode ruft ReadAsync mit CancellationToken.None.(Geerbt von „DbDataReader“.)

System_CAPS_pubmethodReadAsync(CancellationToken)

Dies ist die asynchrone Version der Read. Anbieter sollten durch eine geeignete Implementierung überschreiben. CancellationToken kann optional ignoriert werden.

Die standardmäßige Implementierung ruft die synchrone Read Methode und gibt eine abgeschlossene Aufgabe, die den aufrufenden Thread zu blockieren. Die standardmäßige Implementierung gibt eine abgebrochene Aufgabe zurück, wenn ein bereits abgebrochen CancellationToken übergeben. Lesen ausgelöste Ausnahmen werden über die zurückgegebene Ausnahme einer Aufgabe Eigenschaft mitgeteilt.

Andere Methoden und Eigenschaften nicht Aufrufen der DbDataReader Objekt, bis die zurückgegebene Aufgabe abgeschlossen ist.(Geerbt von „DbDataReader“.)

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von „Object“.)

NameBeschreibung
System_CAPS_pubinterfaceSystem_CAPS_privmethodIDataRecord.GetData(Int32)

Eine Beschreibung dieses Elements finden Sie unter IDataRecord.GetData.(Geerbt von „DbDataReader“.)

NameBeschreibung
System_CAPS_pubmethodAsParallel()

Überladen. Ermöglicht die Parallelisierung einer Abfrage.(Definiert durch ParallelEnumerable.)

System_CAPS_pubmethodAsQueryable()

Überladen. Konvertiert ein IEnumerable zu einer IQueryable.(Definiert durch Queryable.)

System_CAPS_pubmethodCast<TResult>()

Wandelt die Elemente einer IEnumerable in den angegebenen Typ.(Definiert durch Enumerable.)

System_CAPS_pubmethodOfType<TResult>()

Filtert die Elemente einer IEnumerable auf Grundlage eines angegebenen Typs.(Definiert durch Enumerable.)

The T:System.Data.DataTableReader works much like any other data reader, such as the T:System.Data.SqlClient.SqlDataReader, except that the T:System.Data.DataTableReader provides for iterating over rows in a T:System.Data.DataTable. In other words, it provides for iterating over rows in a cache. The cached data can be modified while the T:System.Data.DataTableReader is active, and the reader automatically maintains its position.

When you create a T:System.Data.DataTableReader from a T:System.Data.DataTable, the resulting T:System.Data.DataTableReader object contains one result set with the same data as the T:System.Data.DataTable from which it was created, except for any rows that have been marked as deleted. The columns appear in the same order as in the original T:System.Data.DataTable. The structure of the returned result is identical in schema and data to the original T:System.Data.DataTable. A T:System.Data.DataTableReader that was created by calling the M:System.Data.DataSet.GetDataReader method of a T:System.Data.DataSet object contains multiple result sets if the T:System.Data.DataSetcontains more than one table. The results are in the same sequence as the T:System.Data.DataTableobjects in the T:System.Data.DataTableCollection of the T:System.Data.DataSet object.

The returned result set contains only the current version of each T:System.Data.DataRow; rows that are marked for deletion are skipped.

The DataTableReader provides a stable iterator; that is, the contents of the DataTableReader are not invalidated if the size of the underlying collection is modified during iteration. For example, if one or more rows in the P:System.Data.DataTable.Rows collection are deleted or removed during iteration, the current position within the DataTableReader is maintained appropriately and it does not invalidate the iterator.

.NET Framework
Verfügbar seit 2.0

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: