OleDbDataReader Class

Definition

Bietet ein Verfahren für das Lesen eines Vorwärtsstreams von Datenzeilen aus einer Datenquelle.Provides a way of reading a forward-only stream of data rows from a data source. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

public ref class OleDbDataReader sealed : System::Data::Common::DbDataReader
public ref class OleDbDataReader sealed : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader
public sealed class OleDbDataReader : System.Data.Common.DbDataReader
public sealed class OleDbDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader
type OleDbDataReader = class
    inherit DbDataReader
type OleDbDataReader = class
    inherit MarshalByRefObject
    interface IDataReader
    interface IDisposable
    interface IDataRecord
    interface IEnumerable
Public NotInheritable Class OleDbDataReader
Inherits DbDataReader
Public NotInheritable Class OleDbDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerable
Inheritance
OleDbDataReader
Inheritance
Inheritance
OleDbDataReader

Examples

Im folgenden Beispiel werden eine OleDbConnection, eine OleDbCommandund eine OleDbDataReadererstellt.The following example creates an OleDbConnection, an OleDbCommand, and an OleDbDataReader. Im Beispiel werden die Daten gelesen und in die Konsole geschrieben.The example reads through the data, writing it out to the console. Schließlich schließt das Beispiel den OleDbDataReader und dann die OleDbConnection.Finally, the example closes the OleDbDataReader and then the OleDbConnection.

public static void ReadData(string connectionString, string queryString)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbCommand command = new OleDbCommand(queryString, connection);

        connection.Open();
        OleDbDataReader reader = command.ExecuteReader();

        while (reader.Read())
        {
            Console.WriteLine(reader[0].ToString());
        }
        reader.Close();
    }
}
Public Sub ReadData(ByVal connectionString As String, _
    ByVal queryString As String)
    Using connection As New OleDbConnection(connectionString)
        Dim command As New OleDbCommand(queryString, connection)

        connection.Open()

        Dim reader As OleDbDataReader = command.ExecuteReader()
        While reader.Read()
            Console.WriteLine(reader(0).ToString())
        End While
        reader.Close()
    End Using
End Sub

Remarks

Um einen OleDbDataReaderzu erstellen, müssen Sie die ExecuteReader-Methode des OleDbCommand-Objekts anstelle eines direkten Konstruktors verwenden.To create an OleDbDataReader, you must call the ExecuteReader method of the OleDbCommand object, instead of directly using a constructor.

Bevor Sie den OleDbConnectionschließen, schließen Sie zuerst das OleDbDataReader-Objekt.Before you close the OleDbConnection, first close the OleDbDataReader object. Sie müssen auch das OleDbDataReader Objekt schließen, wenn Sie ein OleDbCommand Objekt fortsetzen möchten. Beispielsweise können Sie erst dann Ausgabeparameter abrufen, nachdem Sie Closeaufgerufen haben.You must also close the OleDbDataReader object if you plan to resuse an OleDbCommand object.For example, you cannot retrieve output parameters until after you call Close.

Während des Lesens von Daten von einem anderen Prozess oder Thread an einem Resultset vorgenommene Änderungen sind für den Benutzer von OleDbDataReader möglicherweise sichtbar.Changes made to a result set by another process or thread while data is being read may be visible to the user of the OleDbDataReader. Das genaue Verhalten ist jedoch zeitabhängig.However, the precise behavior is timing dependent.

IsClosed und RecordsAffected sind die einzigen Eigenschaften, die nach dem Schließen von OleDbDataReader aufgerufen werden können.IsClosed and RecordsAffected are the only properties that you can call after the OleDbDataReader is closed. Obwohl auf die RecordsAffected-Eigenschaft zugegriffen werden kann, während der OleDbDataReader vorhanden ist, müssen Sie vor dem Zurückgeben des Werts von RecordsAffected stets Close aufrufen, um einen exakten Rückgabewert sicherzustellen.Although the RecordsAffected property may be accessed while the OleDbDataReader exists, always call Close before returning the value of RecordsAffected to guarantee an accurate return value.

Properties

Depth

Ruft einen Wert ab, der die Tiefe der Schachtelung für die aktuelle Zeile angibt.Gets a value that indicates 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 OleDbDataReader eine oder mehrere Zeilen enthält.Gets a value that indicates whether the OleDbDataReader contains one or more rows.

IsClosed

Gibt an, ob der Datenreader geschlossen ist.Indicates whether the data reader is closed.

Item[Int32]

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

Item[String]

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

RecordsAffected

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

VisibleFieldCount

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

Methods

Close()

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

CloseAsync()

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

(Inherited from 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.

(Inherited from 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.

(Inherited from 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.

(Inherited from 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.

(Inherited from DbDataReader)
Equals(Object)

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

(Inherited from Object)
Finalize()

Ermöglicht dem Objekt den Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird.Allows the object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

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 Bytewert ab.Gets the value of the specified column as a byte.

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

Liest beginnend am angegebenen Pufferoffset einen Stream von Bytes aus dem angegebenen Spaltenoffset als Array in den Puffer.Reads a stream of bytes from the specified column offset into the buffer as an array starting at the given 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)

Liest einen Datenstrom von Zeichen ab dem angegebenen Pufferoffset als Array aus dem angegebenen Spaltenoffset in den Puffer ab.Reads a stream of characters from the specified column offset into the buffer as an array starting at the given buffer offset.

GetData(Int32)

Gibt ein OleDbDataReader-Objekt für die angeforderte Spaltenordnungszahl zurück.Returns an OleDbDataReader object for the requested column ordinal.

GetDataTypeName(Int32)

Ruft den Namen des Quelldatentyps ab.Gets the name of the source data type.

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.

(Inherited from DbDataReader)
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 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.

(Inherited from 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.

(Inherited from 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.

(Inherited from 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 GUID (Globally Unique Identifier) ab.Gets the value of the specified column as a globally unique identifier (GUID).

GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from 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 32-Bit-Ganzzahl mit Vorzeichen 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.

(Inherited from MarshalByRefObject)
GetName(Int32)

Ruft den Namen der angegebenen Spalte ab.Gets the name of the specified column.

GetOrdinal(String)

Ruft bei angegebenem Spaltennamen die Spaltenordnungszahl ab.Gets the column ordinal, given the name of the column.

GetProviderSpecificFieldType(Int32)

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

(Inherited from DbDataReader)
GetProviderSpecificValue(Int32)

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.

(Inherited from DbDataReader)
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.

(Inherited from DbDataReader)
GetSchemaTable()

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

GetStream(Int32)

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

(Inherited from DbDataReader)
GetString(Int32)

Ruft den Wert der angegebenen Spalte als 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.

(Inherited from DbDataReader)
GetTimeSpan(Int32)

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

GetType()

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

(Inherited from Object)
GetValue(Int32)

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

GetValues(Object[])

Füllt ein Objektarray 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.

(Inherited from 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.

(Inherited from 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.

(Inherited from DbDataReader)
MemberwiseClone()

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

(Inherited from Object)
MemberwiseClone(Boolean)

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

(Inherited from MarshalByRefObject)
NextResult()

Setzt den Datenleser beim Lesen der Ergebnisse von SQL-Anweisungen auf das nächste Ergebnis.Advances the data reader to the next result, when reading the results of batch SQL 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.

(Inherited from 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.

(Inherited from DbDataReader)
Read()

Setzt OleDbDataReader auf den nächsten Datensatz.Advances the OleDbDataReader 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.

(Inherited from 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.

(Inherited from DbDataReader)
ToString()

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

(Inherited from Object)

Explicit Interface Implementations

IDataReader.Close()

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

(Inherited from DbDataReader)
IDataReader.GetSchemaTable()

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

(Inherited from DbDataReader)
IDataRecord.GetData(Int32)

Gibt einen IDataReader für die angegebene Spaltenordnungszahl zurück.Returns an IDataReader for the specified column ordinal.

IDataRecord.GetData(Int32)

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

(Inherited from DbDataReader)
IDisposable.Dispose()

Gibt die Ressourcen frei, die von der aktuellen Instanz der Klasse OleDbDataReader verwendet werden.Releases the resources used by the current instance of the OleDbDataReader class.

IEnumerable.GetEnumerator()

Gibt einen Enumerator zurück, der eine Auflistung durchläuft.Returns an enumerator that iterates through a collection.

Extension Methods

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 DbDataReader-Objekt ab (DbColumn-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.

Applies to

See also