OleDbDataReader Klasse

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
Vererbung
OleDbDataReader
Vererbung
Vererbung
OleDbDataReader
Implementiert

Beispiele

Im folgenden Beispiel werden ein OleDbConnection , ein OleDbCommand und ein erstellt OleDbDataReader .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 die OleDbDataReader und dann das 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

Hinweise

Zum Erstellen eines OleDbDataReader muss die- ExecuteReader Methode des-Objekts aufgerufen OleDbCommand werden, anstatt direkt einen Konstruktor zu verwenden.To create an OleDbDataReader, you must call the ExecuteReader method of the OleDbCommand object, instead of directly using a constructor.

Bevor Sie schließen OleDbConnection , schließen Sie zuerst das- OleDbDataReader Objekt.Before you close the OleDbConnection, first close the OleDbDataReader object. Sie müssen das-Objekt auch schließen OleDbDataReader , wenn Sie ein Objekt fortsetzen möchten OleDbCommand . Beispielsweise können Sie erst dann Ausgabeparameter abrufen, nachdem Sie aufgerufen haben Close .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 OleDbDataReader , während die vorhanden ist, Close müssen Sie vor der Rückgabe des Werts von immer aufrufen, RecordsAffected 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.

Eigenschaften

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 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 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 OleDbDataReader ab.Gets the number of fields in the OleDbDataReader that are not hidden.

Methoden

Close()

Schließt das OleDbDataReader-Objekt.Closes the OleDbDataReader 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 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 mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Geerbt von 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 ein Byte 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.

GetColumnSchemaAsync(CancellationToken)

Dies ist die asynchrone Version von GetColumnSchema(DbDataReader).This is the asynchronous version of GetColumnSchema(DbDataReader). Anbieter sollten mit einer entsprechenden Implementierung überschreiben.Providers should override with an appropriate implementation. Das cancellationToken kann optional berücksichtigt werden.The cancellationToken can optionally be honored. Die Standardimplementierung ruft den asynchronen GetColumnSchema(DbDataReader)-Aufruf auf und gibt eine abgeschlossene Aufgabe zurück.The default implementation invokes the synchronous GetColumnSchema(DbDataReader) call and returns a completed task. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen cancellationToken erhalten wird.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Die Ausnahmen, die von GetColumnSchema(DbDataReader) ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt.Exceptions thrown by GetColumnSchema(DbDataReader) will be communicated via the returned Task Exception property.

(Geerbt von DbDataReader)
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.

(Geerbt von 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.

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

(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 angegebenen Spalte ab.Gets the name of the specified column.

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 anbieterspezifischen Typ der angegebenen Spalte ab.Gets the provider-specific type of the specified column.

(Geerbt von 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.

(Geerbt von 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.

(Geerbt von DbDataReader)
GetSchemaTable()

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

GetSchemaTableAsync(CancellationToken)

Dies ist die asynchrone Version von GetSchemaTable().This is the asynchronous version of GetSchemaTable(). Anbieter sollten mit einer entsprechenden Implementierung überschreiben.Providers should override with an appropriate implementation. Das cancellationToken kann optional berücksichtigt werden.The cancellationToken can optionally be honored. Die Standardimplementierung ruft den asynchronen GetSchemaTable()-Aufruf auf und gibt eine abgeschlossene Aufgabe zurück.The default implementation invokes the synchronous GetSchemaTable() call and returns a completed task. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen cancellationToken erhalten wird.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Die Ausnahmen, die von GetSchemaTable() ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt.Exceptions thrown by GetSchemaTable() will be communicated via the returned Task Exception property.

(Geerbt von 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 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)
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.

(Geerbt von 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 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 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.

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

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

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

IDataRecord.GetData(Int32)

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

(Geerbt von DbDataReader)
IDisposable.Dispose()

Diese API unterstützt die Produktinfrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code gedacht.

Gibt alle von der aktuellen Instanz der OleDbDataReader-Klasse verwendeten Ressourcen frei.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.

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

Gilt für:

Weitere Informationen