EntityDataReader Klasse

Definition

Namespace:

System.Data.EntityClient

Assembly:

System.Data.Entity.dll

Liest einen Vorwärtsstream von Zeilen aus einer Datenquelle.

public ref class EntityDataReader : System::Data::Common::DbDataReader, System::Data::IExtendedDataRecord

public class EntityDataReader : System.Data.Common.DbDataReader, System.Data.IExtendedDataRecord

type EntityDataReader = class
    inherit DbDataReader
    interface IExtendedDataRecord
    interface IDataRecord

Public Class EntityDataReader
Inherits DbDataReader
Implements IExtendedDataRecord

Vererbung

Object

MarshalByRefObject

DbDataReader

EntityDataReader

Implementiert

IDataRecord IExtendedDataRecord

Hinweise

Kombiniert die Funktion der DbDataReader-Klasse mit der Funktion der IExtendedDataRecord-Schnittstelle.

Ein EntityDataReader verfügt über keinen öffentlichen Konstruktor. Sie kann nur über eine der EntityCommand.ExecuteReader Methodenüberladungen abgerufen werden.

SQL Server platziert Ausgabeparameter aus gespeicherten Prozeduren am Ende des Ergebnisdatenstroms nach allen Resultsets. Daher muss eine Anwendung alle Datensätze in allen Resultsets nutzen, um Ausgabeparameterwerte abzurufen. Wenn die Anwendung den EntityDataReader schließt (wodurch auch geschlossen DbDataReaderwürde), werden die Ausgabeparameter möglicherweise nicht aufgefüllt.

EntityDataReader verwendet nicht implizit Resultsets, um Ausgabeparameter verfügbar zu machen. Beachten Sie daher Folgendes:

• EntityDataReader ruft nur auf DbDataReader.NextResult , wenn EntityDataReader.NextResult explizit aufgerufen wird. Wenn DbDataReader.NextResult eine Ausnahme ausgelöst wird, umschließt sie EntityDataReader in eine EntityException (oder eine abgeleitete Ausnahme).

• Close schließt nur , DbDataReaderohne ausstehende Datensätze oder Resultsets zu verwenden.

• Dispose entsorgt nur , DbDataReaderohne ausstehende Datensätze oder Resultsets zu nutzen.

Codebeispiele finden Sie unter Arbeiten mit EntityClient.

Eigenschaften

DataRecordInfo	Ruft die DataRecordInfo für diesen IExtendedDataRecord ab.
Depth	Ruft einen Wert ab, der die Tiefe der Schachtelung für die aktuelle Zeile angibt.
FieldCount	Ruft die Anzahl der Spalten in der aktuellen Zeile ab.
HasRows	Ruft einen Wert ab, der angibt, ob dieser EntityDataReader eine oder mehrere Zeilen enthält.
IsClosed	Ruft einen Wert ab, der angibt, ob der EntityDataReader geschlossen ist.
Item[Int32]	Ruft den Wert der angegebenen Spalte als eine Instanz von Object ab.
Item[String]	Ruft den Wert der angegebenen Spalte als eine Instanz von Object ab.
RecordsAffected	Ruft die Anzahl der durch die Ausführung der SQL-Anweisung geänderten, eingefügten oder gelöschten Zeilen ab.
VisibleFieldCount	Ruft die Anzahl der nicht ausgeblendeten Felder im EntityDataReader ab.

Methoden

Close()	Schließt das EntityDataReader-Objekt.
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 Ressourcen frei, die von diesem EntityDataReader verwendet werden, und ruft Close() auf.
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 booleschen Wert ab.
GetByte(Int32)	Ruft den Wert der angegebenen Spalte als ein Byte ab.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Liest einen Bytestream aus der angegebenen Spalte beginnend an der durch dataIndex angegebenen Position in den Puffer beginnend an der durch bufferIndex angegebenen Position.
GetChar(Int32)	Ruft den Wert der angegebenen Spalte als Einzelzeichen ab.
GetChars(Int32, Int64, Char[], Int32, Int32)	Liest einen Zeichenstream aus der angegebenen Spalte beginnend an der durch dataIndex angegebenen Position in den Puffer beginnend an der durch bufferIndex angegebenen Position.
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)
GetDataReader(Int32)	Gibt geschachtelte Datenleser als DbDataReader-Objekte zurück.
GetDataRecord(Int32)	Gibt einen geschachtelten DbDataRecord zurück.
GetDataTypeName(Int32)	Ruft den Namen des Datentyps der angegebenen Spalte ab.
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.
GetDecimal(Int32)	Ruft den Wert der angegebenen Spalte als Decimal-Objekt ab.
GetDouble(Int32)	Ruft den Wert der angegebenen Spalte als Gleitkommazahl mit doppelter Genauigkeit ab.
GetEnumerator()	Gibt einen IEnumerator zurück, mit dem die Zeilen im Datenleser durchlaufen werden können.
GetFieldType(Int32)	Ruft den Datentyp der angegebenen Spalte ab.
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()	Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetName(Int32)	Ruft den Namen der Spalte anhand der nullbasierten Spaltenordnungszahl ab.
GetOrdinal(String)	Ruft bei angegebenem Spaltennamen die Ordnungszahl der Spalte ab.
GetProviderSpecificFieldType(Int32)	Gibt den anbieterspezifischen Feldtyp der angegebenen Spalte zurück.
GetProviderSpecificValue(Int32)	Ruft den Wert der angegebenen Spalte als eine Instanz von Object ab.
GetProviderSpecificValues(Object[])	Ruft alle anbieterspezifischen Attributspalten in der Auflistung der aktuellen Zeile ab.
GetSchemaTable()	Gibt eine DataTable zurück, die die Spaltenmetadaten des DbDataReader 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 Instanz von String 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 als eine Instanz von Object ab.
GetValues(Object[])	Füllt ein Array von Objekten mit den Spaltenwerten der aktuellen Zeile auf.
InitializeLifetimeService()	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 Datenleser beim Lesen der Ergebnisse von Batchanweisungen auf das nächste Ergebnis.
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 Reader auf den nächsten Datensatz in einem Resultset.
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).
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.