DataTableReader Klasse

Definition

Namespace:

System.Data

Assembly:

System.Data.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

Das DataTableReader funktioniert ähnlich wie jeder andere Datenleser, z. B. der SqlDataReader, mit der Ausnahme, dass die DataTableReader Funktion zum Durchlaufen von Zeilen in einem 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 ein Resultset mit denselben Daten wie die, aus der DataTable es erstellt wurde, mit Ausnahme aller Zeilen, die als gelöscht markiert wurden. Die Spalten werden in der gleichen 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 DataTableCollectionDataSet Objekt.

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

Dies DataTableReader stellt einen stabilen Iterator bereit, d. h. 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 beispielsweise 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

Name	Beschreibung
DataTableReader(DataTable)	Initialisiert eine neue Instanz der DataTableReader Klasse mithilfe von Daten aus dem bereitgestellten DataTable.
DataTableReader(DataTable[])	Initialisiert eine neue Instanz der DataTableReader Klasse mithilfe des bereitgestellten Arrays von DataTable Objekten.

Eigenschaften

Name	Beschreibung
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 ein oder mehrere Zeilen enthält.
IsClosed	Ruft einen Wert ab, der angibt, ob die DataTableReader Zeichenfolge 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 dem DbDataReader nicht ausgeblendeten ab. (Geerbt von DbDataReader)

Methoden

Name	Beschreibung
Close()	Schließt die aktuelle DataTableReader.
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 von den DbDataReader verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen 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 ein Boolean.
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.
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 ein Decimal.
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 Datentyp des Objekts ab.
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()	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 ein String.
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 in der DataTableReader.
GetSchemaTable()	Gibt einen DataTable Wert zurück, der die Spaltenmetadaten der DataTableReader.
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()	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()	DataTableReader Wechselt ggf. zum nächsten Resultset.
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 zum DataTableReader 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

Name	Beschreibung
IDataRecord.GetData(Int32)	Eine Beschreibung dieses Mitglieds finden Sie unter GetData(Int32). (Geerbt von DbDataReader)

Erweiterungsmethoden

Name	Beschreibung
AsParallel(IEnumerable)	Aktiviert die Parallelisierung einer Abfrage.
AsQueryable(IEnumerable)	Wandelt eine IEnumerable in eine IQueryableum.
CanGetColumnSchema(DbDataReader)	Ruft einen Wert ab, der angibt, ob ein DbDataReader Spaltenschema abgerufen werden kann.
Cast<TResult>(IEnumerable)	Wandelt die Elemente eines IEnumerable in den angegebenen Typ um.
GetColumnSchema(DbDataReader)	Ruft das Spaltenschema (DbColumn Auflistung) für ein DbDataReader.
OfType<TResult>(IEnumerable)	Filtert die Elemente einer IEnumerable basierend auf einem angegebenen Typ.