EntityDataReader Klasse

Definition

Liest einen Vorwärtsstream von Zeilen aus einer Datenquelle.Reads a forward-only stream of rows from a data source.

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
Implementiert

Hinweise

Kombiniert die Funktion der DbDataReader-Klasse mit der Funktion der IExtendedDataRecord-Schnittstelle.Combines the functionality of the DbDataReader class and the IExtendedDataRecord interface.

Ein EntityDataReader verfügt über keinen öffentlichen Konstruktor.An EntityDataReader has no public constructor. Sie kann nur über eine der EntityCommand.ExecuteReader -Methoden Überladungen abgerufen werden.It can only be obtained through one of the EntityCommand.ExecuteReader method overloads.

SQL Server legt Ausgabeparameter aus gespeicherten Prozeduren am Ende des Ergebnisdaten Stroms nach allen Resultsets ab.SQL Server puts output parameters from stored procedures at the end of the result stream, after all the result sets. Daher muss eine Anwendung alle Datensätze in allen Resultsets verarbeiten, um Ausgabeparameter Werte zu erhalten.Therefore, to get output parameter values, an application must consume all the records in all the result sets. Wenn die Anwendung das EntityDataReader schließt (was auch das DbDataReaderschließen würde), werden die Ausgabeparameter möglicherweise nicht aufgefüllt.If the application closes the EntityDataReader (which would also close the DbDataReader), output parameters might not be populated.

EntityDataReaderverwendet nicht implizit Resultsets, um Ausgabeparameter verfügbar zu machen.EntityDataReader does not implicitly consume result sets to make output parameters available. Beachten Sie daher Folgendes:Therefore, note the following:

Codebeispiele finden Sie unter Arbeiten mit EntityClient.For code examples, see Working with EntityClient.

Eigenschaften

DataRecordInfo

Ruft die DataRecordInfo für diesen IExtendedDataRecord ab.Gets DataRecordInfo for this IExtendedDataRecord.

Depth

Ruft einen Wert ab, der die Tiefe der Schachtelung für die aktuelle Zeile angibt.Gets a value indicating the depth of nesting for the current row.

FieldCount

Ruft die Anzahl der Spalten in der aktuellen Zeile ab.Gets the number of columns in the current row.

HasRows

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

IsClosed

Ruft einen Wert ab, der angibt, ob der EntityDataReader geschlossen ist.Gets a value indicating whether the EntityDataReader is closed.

Item[Int32]

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

Item[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.

RecordsAffected

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

VisibleFieldCount

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

Methoden

Close()

Schließt das EntityDataReader-Objekt.Closes the EntityDataReader object.

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 Ressourcen frei, die von diesem EntityDataReader verwendet werden, und ruft Close() auf.Releases the resources consumed by this EntityDataReader and calls Close().

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)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetBoolean(Int32)

Ruft den Wert der angegebenen Spalte als booleschen Wert 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 einen Bytestream aus der angegebenen Spalte beginnend an der durch dataIndex angegebenen Position in den Puffer beginnend an der durch bufferIndex angegebenen Position.Reads a stream of bytes from the specified column, starting at location indicated by dataIndex, into the buffer, starting at the location indicated by bufferIndex.

GetChar(Int32)

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

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.Reads a stream of characters from the specified column, starting at location indicated by dataIndex, into the buffer, starting at the location indicated by bufferIndex.

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)
GetDataReader(Int32)

Gibt geschachtelte Datenleser als DbDataReader-Objekte zurück.Returns nested readers as DbDataReader objects.

GetDataRecord(Int32)

Gibt einen geschachtelten DbDataRecord zurück.Returns a nested DbDataRecord.

GetDataTypeName(Int32)

Ruft den Namen des Datentyps der angegebenen Spalte ab.Gets the name of 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.

GetDecimal(Int32)

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

GetDouble(Int32)

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.

GetEnumerator()

Gibt einen IEnumerator zurück, mit dem die Zeilen im Datenleser durchlaufen werden können.Returns an IEnumerator that can be used to iterate through the rows in the data reader.

GetFieldType(Int32)

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

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 Namen der Spalte anhand der nullbasierten Spaltenordnungszahl ab.Gets the name of the column, given the zero-based column ordinal.

GetOrdinal(String)

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

GetProviderSpecificFieldType(Int32)

Gibt den anbieterspezifischen Feldtyp der angegebenen Spalte zurück.Returns the provider-specific field type of the specified column.

GetProviderSpecificValue(Int32)

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

GetProviderSpecificValues(Object[])

Ruft alle anbieterspezifischen Attributspalten in der Auflistung der aktuellen Zeile ab.Gets all provider-specific attribute columns in the collection for the current row.

GetSchemaTable()

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

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 Instanz von String ab.Gets the value of the specified column as an instance of 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 als Instanz von Object ab.Gets the value of the specified column as an instance of Object.

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 nonexistent 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 Datenleser beim Lesen der Ergebnisse von Batchanweisungen auf das nächste Ergebnis.Advances the reader to the next result when reading the results of a batch of statements.

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 Reader auf den nächsten Datensatz in einem Resultset.Advances the reader to the next record in a result set.

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 Members finden Sie unter Close().For a description of this member, see Close().

(Geerbt von DbDataReader)
IDataReader.GetSchemaTable()

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

(Geerbt von DbDataReader)
IDataRecord.GetData(Int32)

Eine Beschreibung dieses Members 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.

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: