DbDataReader Klasse

Definition

Namespace:

System.Data.Common

Assembly:

System.Data.Common.dll

Quelle:

DbDataReader.cs

Liest einen vorwärtsgeschützten Datenstrom von Zeilen aus einer Datenquelle.

public ref class DbDataReader abstract : MarshalByRefObject, IAsyncDisposable, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader

public abstract class DbDataReader : MarshalByRefObject, IAsyncDisposable, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader

type DbDataReader = class
    inherit MarshalByRefObject
    interface IEnumerable
    interface IDataReader
    interface IDataRecord
    interface IDisposable
    interface IAsyncDisposable

Public MustInherit Class DbDataReader
Inherits MarshalByRefObject
Implements IAsyncDisposable, IDataReader, IDisposable, IEnumerable

Vererbung

Object

MarshalByRefObject

DbDataReader

Abgeleitet

System.Data.DataTableReader

System.Data.EntityClient.EntityDataReader

System.Data.Odbc.OdbcDataReader

System.Data.OleDb.OleDbDataReader

System.Data.SqlClient.SqlDataReader

Implementiert

IEnumerable IDisposable IDataReader IDataRecord IAsyncDisposable

Konstruktoren

DbDataReader()

Initialisiert eine neue Instanz der DbDataReader Klasse.

Eigenschaften

Depth	Ruft einen Wert ab, der die Tiefe der Schachtelung für die aktuelle Zeile angibt.
FieldCount	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die Anzahl der Spalten in der aktuellen Zeile abgerufen.
HasRows	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Wert abgerufen, der angibt, ob diese DbDataReader mindestens eine Zeile enthält.
IsClosed	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert abgerufen, der angibt, ob die DbDataReader geschlossen ist.
Item[Int32]	Wenn eine abgeleitete Klasse überschrieben wird, wird der Wert der angegebenen Spalte als Instanz von Objectabgerufen.
Item[String]	Wenn eine abgeleitete Klasse überschrieben wird, wird der Wert der angegebenen Spalte als Instanz von Objectabgerufen.
RecordsAffected	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die Anzahl der Zeilen durch Ausführung der SQL-Anweisung geändert, eingefügt oder gelöscht.
VisibleFieldCount	Ruft die Anzahl der Felder in der DbDataReader ab, die nicht ausgeblendet sind.

Methoden

Close()	Schließt das DbDataReader-Objekt.
CloseAsync()	Schließt das DbDataReader-Objekt asynchron.
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.
Dispose(Boolean)	Gibt die nicht verwalteten Ressourcen frei, die vom DbDataReader verwendet werden, und gibt optional die verwalteten Ressourcen frei.
DisposeAsync()	Gibt asynchron alle Ressourcen frei, die von der aktuellen Instanz der DbDataReader Klasse verwendet werden.
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
GetBoolean(Int32)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Wert der angegebenen Spalte als boolescher Wert abgerufen.
GetByte(Int32)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Wert der angegebenen Spalte als Byte abgerufen.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Wenn sie in einer abgeleiteten Klasse überschrieben werden, liest sie 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(Int32)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Wert der angegebenen Spalte als einzelnes Zeichen abgerufen.
GetChars(Int32, Int64, Char[], Int32, Int32)	Wenn sie in einer abgeleiteten Klasse überschrieben werden, liest sie eine angegebene Anzahl von Zeichen aus einer angegebenen Spalte beginnend mit einem angegebenen Index und schreibt sie in einen Puffer, der an einer angegebenen Position beginnt.
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.
GetData(Int32)	Gibt einen geschachtelten Datenleser für die angeforderte Spalte zurück.
GetDataTypeName(Int32)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, ruft der Name des Datentyps der angegebenen Spalte ab.
GetDateTime(Int32)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Wert der angegebenen Spalte als DateTime -Objekt abgerufen.
GetDbDataReader(Int32)	Gibt ein DbDataReader -Objekt für die angeforderte Spalten-Ordnungszahl zurück, die mit einer anbieterspezifischen Implementierung überschrieben werden kann.
GetDecimal(Int32)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Wert der angegebenen Spalte als Decimalabgerufen.
GetDouble(Int32)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Wert der angegebenen Spalte als Gleitkommazahl mit doppelter Genauigkeit abgerufen.
GetEnumerator()	Wenn eine abgeleitete Klasse überschrieben wird, wird ein Enumerationsmodul zurückgegeben, mit dem die Zeilen im Datenleser durchlaufen werden können.
GetFieldType(Int32)	Beim Überschreiben in einer abgeleiteten Klasse ruft den Datentyp der angegebenen Spalte ab.
GetFieldValue<T>(Int32)	Ruft den Wert der angegebenen Spalte als angeforderten Typ ab.
GetFieldValueAsync<T>(Int32, CancellationToken)	Ruft asynchron den Wert der angegebenen Spalte als angeforderten Typ ab.
GetFieldValueAsync<T>(Int32)	Ruft asynchron den Wert der angegebenen Spalte als angeforderten Typ ab.
GetFloat(Int32)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Wert der angegebenen Spalte als Gleitkommazahl mit einfacher Genauigkeit abgerufen.
GetGuid(Int32)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Wert der angegebenen Spalte als GUID (Globally Unique Identifier) abgerufen.
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetInt16(Int32)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Wert der angegebenen Spalte als eine 16-Bit-ganzzahlige Vorzeichen abgerufen.
GetInt32(Int32)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Wert der angegebenen Spalte als eine 32-Bit-ganzzahlige Vorzeichen abgerufen.
GetInt64(Int32)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Wert der angegebenen Spalte als eine 64-Bit-ganzzahlige Vorzeichen abgerufen.
GetLifetimeService()	Veraltet. Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinie für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetName(Int32)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird der Name der Spalte anhand der nullbasierten Spalten-Ordnungszahl ermittelt.
GetOrdinal(String)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, ruft die Spalten-Ordnungszahl ab, die dem Namen der Spalte gegeben ist.
GetProviderSpecificFieldType(Int32)	Ruft den anbieterspezifischen Typ der angegebenen Spalte ab.
GetProviderSpecificValue(Int32)	Ruft den Wert der angegebenen Spalte als Instanz eines anbieterspezifischen Typs ab.
GetProviderSpecificValues(Object[])	Ruft alle anbieterspezifischen Attributspalten in der Auflistung für die aktuelle Zeile ab.
GetSchemaTable()	Gibt einen DataTable zurück, der die Spaltenmetadaten des DbDataReaderbeschreibt. Gibt null zurück, wenn der ausgeführte Befehl kein Resultset zurückgegeben hat, oder wenn NextResult()falsezurückgibt.
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.
GetStream(Int32)	Ruft einen Datenstrom ab, um Daten aus der angegebenen Spalte abzurufen.
GetString(Int32)	Wenn eine abgeleitete Klasse überschrieben wird, wird der Wert der angegebenen Spalte als Instanz von Stringabgerufen.
GetTextReader(Int32)	Ruft einen Textleser ab, um Daten aus der Spalte abzurufen.
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
GetValue(Int32)	Wenn eine abgeleitete Klasse überschrieben wird, wird der Wert der angegebenen Spalte als Instanz von Objectabgerufen.
GetValues(Object[])	Wenn sie in einer abgeleiteten Klasse überschrieben werden, füllen Sie 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)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Wert abgerufen, 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.
IsDBNullAsync(Int32)	Ruft asynchron einen Wert ab, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält.
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()	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wechselt der Leser zum nächsten Ergebnis, wenn die Ergebnisse einer Reihe von Anweisungen gelesen werden.
NextResultAsync()	Wechselt den Leser asynchron zum nächsten Ergebnis, wenn die Ergebnisse einer Reihe von Anweisungen gelesen werden.
NextResultAsync(CancellationToken)	Wechselt den Leser asynchron zum nächsten Ergebnis, wenn die Ergebnisse einer Reihe von Anweisungen gelesen werden.
Read()	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wechselt der Leser zum nächsten Datensatz in einem Resultset.
ReadAsync()	Wechselt den Leser asynchron zum nächsten Datensatz in einem Resultset.
ReadAsync(CancellationToken)	Wechselt den Leser asynchron zum nächsten Datensatz in einem Resultset.
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).

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.

Weitere Informationen

• DbProviderFactories (ADO.NET)
• ADO.NET Übersicht