DataTableReader Klasse

Definition

Der DataTableReader ruft den Inhalt eines oder mehrerer DataTable-Objekte in Form eines oder mehrerer schreibgeschützter vorwärts gerichteter Resultsets ab.The DataTableReader obtains the contents of one or more DataTable objects in the form of one or more read-only, forward-only result sets.

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
DataTableReader
Vererbung

Hinweise

Der DataTableReader funktioniert ähnlich wie jeder andere Daten Leser, z. b. die SqlDataReader, mit dem Unterschied, dass der DataTableReader zum Durchlaufen von Zeilen in einer DataTablebereitstellt.The DataTableReader works much like any other data reader, such as the SqlDataReader, except that the DataTableReader provides for iterating over rows in a DataTable. Das heißt, Sie ermöglicht das Durchlaufen von Zeilen in einem Cache.In other words, it provides for iterating over rows in a cache. Die zwischengespeicherten Daten können geändert werden, während die DataTableReader aktiv ist, und der Reader behält seine Position automatisch bei.The cached data can be modified while the DataTableReader is active, and the reader automatically maintains its position.

Wenn Sie einen DataTableReader aus einem DataTableerstellen, enthält das resultierende DataTableReader Objekt ein Resultset mit denselben Daten wie das DataTable, von dem es erstellt wurde, mit Ausnahme von Zeilen, die als gelöscht markiert wurden.When you create a DataTableReader from a DataTable, the resulting DataTableReader object contains one result set with the same data as the DataTable from which it was created, except for any rows that have been marked as deleted. Die Spalten werden in der gleichen Reihenfolge wie im ursprünglichen DataTableangezeigt.The columns appear in the same order as in the original DataTable. Die Struktur des zurückgegebenen Ergebnisses ist mit dem Schema und den Daten mit dem ursprünglichen DataTableidentisch.The structure of the returned result is identical in schema and data to the original DataTable. Eine DataTableReader, die durch Aufrufen der CreateDataReader-Methode eines DataSet-Objekts erstellt wurde, enthält mehrere Resultsets, wenn die DataSet mehr als eine Tabelle enthält.A DataTableReader that was created by calling the CreateDataReader method of a DataSet object contains multiple result sets if the DataSet contains more than one table. Die Ergebnisse befinden sich in derselben Reihenfolge wie die DataTable Objekte in der DataTableCollection des DataSet Objekts.The results are in the same sequence as the DataTable objects in the DataTableCollection of the DataSet object.

Das zurückgegebene Resultset enthält nur die aktuelle Version der einzelnen DataRow; Zeilen, die zum Löschen markiert sind, werden übersprungen.The returned result set contains only the current version of each DataRow; rows that are marked for deletion are skipped.

Der DataTableReader stellt einen stabilen Iterator bereit. Das heißt, dass der Inhalt des DataTableReader nicht ungültig gemacht wird, wenn die Größe der zugrunde liegenden Auflistung während der Iterations Änderung geändert wird.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. Wenn z. b. eine oder mehrere Zeilen in der Rows Auflistung während der Iterationen gelöscht oder entfernt werden, wird die aktuelle Position innerhalb der DataTableReader ordnungsgemäß verwaltet, und der Iterator wird nicht für ungültig erklärt.For example, if one or more rows in the Rows collection are deleted or removed during iteration, the current position within the DataTableReader is maintained appropriately and it does not invalidate the iterator.

Konstruktoren

DataTableReader(DataTable)

Initialisiert unter Verwendung von Daten aus der bereitgestellten DataTableReader eine neue Instanz der DataTable-Klasse.Initializes a new instance of the DataTableReader class by using data from the supplied DataTable.

DataTableReader(DataTable[])

Initialisiert eine neue Instanz der DataTableReader-Klasse unter Verwendung des bereitgestellten Arrays von DataTable-Objekten.Initializes a new instance of the DataTableReader class using the supplied array of DataTable objects.

Eigenschaften

Depth

Die Tiefe der Schachtelung für die aktuelle Zeile des DataTableReader.The depth of nesting for the current row of the DataTableReader.

FieldCount

Gibt die Anzahl der Spalten in der aktuellen Zeile zurück.Returns the number of columns in the current row.

HasRows

Ruft einen Wert ab, der angibt, ob DataTableReader eine oder mehrere Zeilen enthält.Gets a value that indicates whether the DataTableReader contains one or more rows.

IsClosed

Ruft einen Wert ab, der angibt, ob der DataTableReader synchronisiert ist.Gets a value that indicates whether the DataTableReader is closed.

Item[Int32]

Ruft bei angegebener Spaltenordnungszahl den Wert der angegebenen Spalte im systemeigenen Format ab.Gets the value of the specified column in its native format given the column ordinal.

Item[String]

Ruft bei angegebenem Spaltennamen den Wert der angegebenen Spalte im systemeigenen Format ab.Gets the value of the specified column in its native format given the column name.

RecordsAffected

Ruft die Anzahl der durch die Ausführung der SQL-Anweisung eingefügten, geänderten oder gelöschten Zeilen ab.Gets the number of rows inserted, changed, or deleted by execution of the SQL statement.

VisibleFieldCount

Ruft die Anzahl der nicht ausgeblendeten Felder im DbDataReader ab.Gets the number of fields in the DbDataReader that are not hidden.

(Geerbt von DbDataReader)

Methoden

Close()

Schließt den aktuellen DataTableReader.Closes the current DataTableReader.

CloseAsync()

Schließt das DbDataReader-Objekt asynchronAsynchronously closes the DbDataReader object.

(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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Geerbt von MarshalByRefObject)
Dispose()

Gibt alle von der aktuellen Instanz der DbDataReader-Klasse verwendeten Ressourcen frei.Releases all resources used by the current instance of the DbDataReader class.

(Geerbt von DbDataReader)
Dispose(Boolean)

Gibt die von DbDataReader verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the DbDataReader and optionally releases the managed resources.

(Geerbt von DbDataReader)
DisposeAsync()

Gibt alle von der aktuellen Instanz der DbDataReader-Klasse verwendeten Ressourcen asynchron frei.Asynchronously releases all resources used by the current instance of the DbDataReader class.

(Geerbt von DbDataReader)
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetBoolean(Int32)

Ruft den Wert der angegebenen Spalte als Boolean ab.Gets the value of the specified column as a Boolean.

GetByte(Int32)

Ruft den Wert der angegebenen Spalte als ein Byte ab.Gets the value of the specified column as a byte.

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

Liest beginnend am jeweiligen Pufferoffset einen Stream von Bytes aus dem angegebenen Spaltenoffset als Array in den Puffer.Reads a stream of bytes starting at the specified column offset into the buffer as an array starting at the specified buffer offset.

GetChar(Int32)

Ruft den Wert der angegebenen Spalte als Zeichen ab.Gets the value of the specified column as a character.

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

Gibt den Wert der angegebenen Spalte als Zeichenarray zurück.Returns the value of the specified column as a character array.

GetData(Int32)

Gibt einen verschachtelten Datenreader für die angeforderte Spalte zurück.Returns a nested data reader for the requested column.

(Geerbt von DbDataReader)
GetDataTypeName(Int32)

Ruft eine Zeichenfolge ab, die den Datentyp der angegebenen Spalte darstellt.Gets a string representing the data type of the specified column.

GetDateTime(Int32)

Ruft den Wert der angegebenen Spalte als DateTime-Objekt ab.Gets the value of the specified column as a DateTime object.

GetDbDataReader(Int32)

Gibt ein DbDataReader-Objekt für die angeforderte Spaltenordnungszahl zurück, das mit einer anbieterspezifischen Implementierung überschrieben werden kann.Returns a DbDataReader object for the requested column ordinal that can be overridden with a provider-specific implementation.

(Geerbt von DbDataReader)
GetDecimal(Int32)

Ruft den Wert der angegebenen Spalte als Decimal ab.Gets the value of the specified column as a Decimal.

GetDouble(Int32)

Ruft den Wert der Spalte als Gleitkommazahl mit doppelter Genauigkeit ab.Gets the value of the column as a double-precision floating point number.

GetEnumerator()

Gibt einen Enumerator zurück, der zum Durchlaufen der Elementauflistung verwendet werden kann.Returns an enumerator that can be used to iterate through the item collection.

GetFieldType(Int32)

Ruft den Type ab, der den Datentyp des Objekts darstellt.Gets the Type that is the data type of the object.

GetFieldValue<T>(Int32)

Ruft den Wert der angegebenen Spalte als angeforderten Typ ab.Gets the value of the specified column as the requested type.

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

Ruft den Wert der angegebenen Spalte asynchron als angeforderten Typ ab.Asynchronously gets the value of the specified column as the requested type.

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

Ruft den Wert der angegebenen Spalte asynchron als angeforderten Typ ab.Asynchronously gets the value of the specified column as the requested type.

(Geerbt von DbDataReader)
GetFloat(Int32)

Ruft den Wert der angegebenen Spalte als Gleitkommazahl mit einfacher Genauigkeit ab.Gets the value of the specified column as a single-precision floating point number.

GetGuid(Int32)

Ruft den Wert der angegebenen Spalte als global eindeutigen Bezeichner (Globally Unique Identifier, GUID) ab.Gets the value of the specified column as a globally-unique identifier (GUID).

GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetInt16(Int32)

Ruft den Wert der angegebenen Spalte als 16-Bit-Ganzzahl mit Vorzeichen ab.Gets the value of the specified column as a 16-bit signed integer.

GetInt32(Int32)

Ruft den Wert der angegebenen Spalte als ganze Zahl mit Vorzeichen und einer Länge von 32 Bit ab.Gets the value of the specified column as a 32-bit signed integer.

GetInt64(Int32)

Ruft den Wert der angegebenen Spalte als 64-Bit-Ganzzahl mit Vorzeichen ab.Gets the value of the specified column as a 64-bit signed integer.

GetLifetimeService()

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Geerbt von MarshalByRefObject)
GetName(Int32)

Ruft den Wert der angegebenen Spalte als String ab.Gets the value of the specified column as a String.

GetOrdinal(String)

Ruft bei angegebenem Spaltennamen die Ordnungszahl der Spalte ab.Gets the column ordinal, given the name of the column.

GetProviderSpecificFieldType(Int32)

Ruft den Typ der angegebenen Spalte im anbieterspezifischen Format ab.Gets the type of the specified column in provider-specific format.

GetProviderSpecificValue(Int32)

Ruft den Wert der angegebenen Spalte im anbieterspezifischen Format ab.Gets the value of the specified column in provider-specific format.

GetProviderSpecificValues(Object[])

Füllt das angegebene Array mit anbieterspezifischen Typinformationen für alle Spalten im DataTableReader auf.Fills the supplied array with provider-specific type information for all the columns in the DataTableReader.

GetSchemaTable()

Gibt eine DataTable zurück, die die Spaltenmetadaten des DataTableReader beschreibt.Returns a DataTable that describes the column metadata of the DataTableReader.

GetStream(Int32)

Ruft einen Stream ab, um Daten aus der angegebenen Spalte abzurufen.Gets a stream to retrieve data from the specified column.

(Geerbt von DbDataReader)
GetString(Int32)

Ruft den Wert der angegebenen Spalte als eine Zeichenfolge ab.Gets the value of the specified column as a string.

GetTextReader(Int32)

Ruft einen Textreader zum Auslesen von Daten aus der Spalte ab.Gets a text reader to retrieve data from the column.

(Geerbt von DbDataReader)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
GetValue(Int32)

Ruft den Wert der angegebenen Spalte im systemeigenen Format ab.Gets the value of the specified column in its native format.

GetValues(Object[])

Füllt ein Array von Objekten mit den Spaltenwerten der aktuellen Zeile auf.Populates an array of objects with the column values of the current row.

InitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.Obtains a lifetime service object to control the lifetime policy for this instance.

(Geerbt von MarshalByRefObject)
IsDBNull(Int32)

Ruft einen Wert ab, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält.Gets a value that indicates whether the column contains non-existent or missing values.

IsDBNullAsync(Int32)

Ruft asynchron einen Wert ab, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

(Geerbt von DbDataReader)
IsDBNullAsync(Int32, CancellationToken)

Ruft asynchron einen Wert ab, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

(Geerbt von DbDataReader)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.Creates a shallow copy of the current MarshalByRefObject object.

(Geerbt von MarshalByRefObject)
NextResult()

Setzt den DataTableReader auf das nächste Resultset, sofern vorhanden.Advances the DataTableReader to the next result set, if any.

NextResultAsync()

Setzt den Datenreader beim Lesen der Ergebnisse von Batchanweisungen asynchron auf das nächste Ergebnis.Asynchronously advances the reader to the next result when reading the results of a batch of statements.

(Geerbt von DbDataReader)
NextResultAsync(CancellationToken)

Setzt den Datenreader beim Lesen der Ergebnisse von Batchanweisungen asynchron auf das nächste Ergebnis.Asynchronously advances the reader to the next result when reading the results of a batch of statements.

(Geerbt von DbDataReader)
Read()

Setzt den DataTableReader auf den nächsten Datensatz.Advances the DataTableReader to the next record.

ReadAsync()

Setzt den Reader asynchron auf den nächsten Datensatz in einem Resultset.Asynchronously advances the reader to the next record in a result set.

(Geerbt von DbDataReader)
ReadAsync(CancellationToken)

Setzt den Reader asynchron auf den nächsten Datensatz in einem Resultset.Asynchronously advances the reader to the next record in a result set.

(Geerbt von DbDataReader)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

IDataReader.Close()

Eine Beschreibung dieses Elements finden Sie unter Close().For a description of this member, see Close().

(Geerbt von DbDataReader)
IDataReader.GetSchemaTable()

Eine Beschreibung dieses Elements finden Sie unter GetSchemaTable().For a description of this member, see GetSchemaTable().

(Geerbt von DbDataReader)
IDataRecord.GetData(Int32)

Eine Beschreibung dieses Elements finden Sie unter GetData(Int32).For a description of this member, see GetData(Int32).

(Geerbt von DbDataReader)

Erweiterungsmethoden

CanGetColumnSchema(DbDataReader)

Ruft einen Wert ab, der angibt, ob ein DbDataReader-Objekt ein Spaltenschema haben kann.Gets a value that indicates whether a DbDataReader can get a column schema.

GetColumnSchema(DbDataReader)

Ruft das Spaltenschema für ein DbColumn-Objekt ab (DbDataReader-Auflistung).Gets the column schema (DbColumn collection) for a DbDataReader.

GetBoolean(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als booleschen Wert ab.Gets the value of the specified column as a Boolean.

GetByte(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als ein Byte ab.Gets the value of the specified column as a byte.

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.Reads a specified number of bytes from the specified column starting at a specified index and writes them to a buffer starting at a specified position in the buffer.

GetChar(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als ein einzelnes Zeichen ab.Gets the value of the specified column as a single character.

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.Reads a specified number of characters from a specified column starting at a specified index, and writes them to a buffer starting at a specified position.

GetData(DbDataReader, String)

Gibt einen verschachtelten Datenreader für die angeforderte Spalte zurück.Returns a nested data reader for the requested column.

GetDataTypeName(DbDataReader, String)

Ruft den Namen des Datentyps der angegebenen Spalte ab.Gets name of the data type of the specified column.

GetDateTime(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als DateTime-Objekt ab.Gets the value of the specified column as a DateTime object.

GetDecimal(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als Decimal ab.Gets the value of the specified column as a Decimal.

GetDouble(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als Gleitkommazahl mit doppelter Genauigkeit ab.Gets the value of the specified column as a double-precision floating point number.

GetFieldType(DbDataReader, String)

Ruft den Datentyp der angegebenen Spalte ab.Gets the data type of the specified column.

GetFieldValue<T>(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als angeforderten Typ ab.Gets the value of the specified column as the requested type.

GetFieldValueAsync<T>(DbDataReader, String, CancellationToken)

Ruft den Wert der angegebenen Spalte asynchron als angeforderten Typ ab.Asynchronously gets the value of the specified column as the requested type.

GetFloat(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als Gleitkommazahl mit einfacher Genauigkeit ab.Gets the value of the specified column as a single-precision floating point number.

GetGuid(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als global eindeutigen Bezeichner (Globally Unique Identifier, GUID) ab.Gets the value of the specified column as a globally unique identifier (GUID).

GetInt16(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als 16-Bit-Ganzzahl mit Vorzeichen ab.Gets the value of the specified column as a 16-bit signed integer.

GetInt32(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als ganze Zahl mit Vorzeichen und einer Länge von 32 Bit ab.Gets the value of the specified column as a 32-bit signed integer.

GetInt64(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als 64-Bit-Ganzzahl mit Vorzeichen ab.Gets the value of the specified column as a 64-bit signed integer.

GetProviderSpecificFieldType(DbDataReader, String)

Ruft den anbieterspezifischen Typ der angegebenen Spalte ab.Gets the provider-specific type of the specified column.

GetProviderSpecificValue(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als Instanz eines anbieterspezifischen Typs ab.Gets the value of the specified column as an instance of a provider-specific type.

GetStream(DbDataReader, String)

Ruft einen Stream ab, um Daten aus der angegebenen Spalte abzurufen.Gets a stream to retrieve data from the specified column.

GetString(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als eine Instanz von String ab.Gets the value of the specified column as an instance of String.

GetTextReader(DbDataReader, String)

Ruft einen Textreader zum Auslesen von Daten aus der Spalte ab.Gets a text reader to retrieve data from the column.

GetValue(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als eine Instanz von Object ab.Gets the value of the specified column as an instance of Object.

IsDBNull(DbDataReader, String)

Ruft einen Wert ab, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält.Gets a value that indicates whether the column contains nonexistent or missing values.

IsDBNullAsync(DbDataReader, String, CancellationToken)

Ruft asynchron einen Wert ab, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

Cast<TResult>(IEnumerable)

Wandelt die Elemente eines IEnumerable in den angegebenen Typ umCasts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtert die Elemente eines IEnumerable anhand eines angegebenen TypsFilters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Ermöglicht die Parallelisierung einer Abfrage.Enables parallelization of a query.

AsQueryable(IEnumerable)

Konvertiert einen IEnumerable in einen IQueryable.Converts an IEnumerable to an IQueryable.

Gilt für: