OleDbDataReader OleDbDataReader OleDbDataReader 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 sealed class OleDbDataReader : System.Data.Common.DbDataReader
type OleDbDataReader = class
    inherit DbDataReader
Public NotInheritable Class OleDbDataReader
Inherits DbDataReader
Vererbung

Beispiele

Im folgenden Beispiel werden ein OleDbConnection, ein OleDbCommandund OleDbDataReaderein erstellt.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. OleDbConnectionFinally, 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 OleDbDataReadermuss die ExecuteReader -Methode des OleDbCommand -Objekts aufgerufen 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 OleDbDataReader -Objekt auch 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.

Änderungen, die an einem Resultset durch einen anderen Prozess oder Thread vorgenommen werden, während die Daten gelesen werden, sind OleDbDataReadermöglicherweise für den Benutzer des 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 hängt jedoch von der zeitlichen Steuerung ab.However, the precise behavior is timing dependent.

IsClosedund RecordsAffected sind die einzigen Eigenschaften, die Sie nach dem OleDbDataReader schließen von aufzurufen können.IsClosed and RecordsAffected are the only properties that you can call after the OleDbDataReader is closed. Obwohl auf RecordsAffected die-Eigenschaft zugegriffen werden kann OleDbDataReader , während die vorhanden Close ist, müssen Sie vor RecordsAffected der Rückgabe des Werts von immer 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.

Eigenschaften

Depth Depth Depth 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 FieldCount FieldCount FieldCount

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

HasRows HasRows HasRows 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 IsClosed IsClosed IsClosed

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

Item[Int32] Item[Int32] Item[Int32] 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] Item[String] Item[String] 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 RecordsAffected RecordsAffected 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 VisibleFieldCount VisibleFieldCount 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() Close() Close() Close()

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

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) 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)
Equals(Object) Equals(Object) Equals(Object) 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() Finalize() Finalize() 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) GetBoolean(Int32) GetBoolean(Int32) GetBoolean(Int32)

Ruft den Wert der angegebenen Spalte als booleschen Wert ab.Gets the value of the specified column as a Boolean.

GetByte(Int32) GetByte(Int32) GetByte(Int32) 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) GetBytes(Int32, Int64, Byte[], Int32, Int32) GetBytes(Int32, Int64, Byte[], Int32, Int32) 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) GetChar(Int32) GetChar(Int32) 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) GetChars(Int32, Int64, Char[], Int32, Int32) GetChars(Int32, Int64, Char[], Int32, Int32) GetChars(Int32, Int64, Char[], Int32, Int32)

Liest beginnend am angegebenen Pufferoffset einen Stream von Zeichen aus dem angegebenen Spaltenoffset in den Puffer eines Arrays.Reads a stream of characters from the specified column offset into the buffer as an array starting at the given buffer offset.

GetData(Int32) GetData(Int32) GetData(Int32) GetData(Int32)

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

GetDataTypeName(Int32) GetDataTypeName(Int32) GetDataTypeName(Int32) GetDataTypeName(Int32)

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

GetDateTime(Int32) GetDateTime(Int32) GetDateTime(Int32) GetDateTime(Int32)

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

GetDecimal(Int32) GetDecimal(Int32) GetDecimal(Int32) 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) GetDouble(Int32) GetDouble(Int32) 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() GetEnumerator() GetEnumerator() 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) GetFieldType(Int32) GetFieldType(Int32) GetFieldType(Int32)

Ruft den Type ab, der den Datentyp des Objekts darstellt.Gets the Type that is the data type of the object.

GetFloat(Int32) GetFloat(Int32) GetFloat(Int32) 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) GetGuid(Int32) GetGuid(Int32) 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() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetInt16(Int32) GetInt16(Int32) GetInt16(Int32) 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) GetInt32(Int32) GetInt32(Int32) 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) GetInt64(Int32) GetInt64(Int32) 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() GetLifetimeService() GetLifetimeService() 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) GetName(Int32) GetName(Int32) GetName(Int32)

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

GetOrdinal(String) GetOrdinal(String) GetOrdinal(String) GetOrdinal(String)

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

GetSchemaTable() GetSchemaTable() GetSchemaTable() GetSchemaTable()

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

GetString(Int32) GetString(Int32) GetString(Int32) GetString(Int32)

Ruft den Wert der angegebenen Spalte als eine Zeichenfolge ab.Gets the value of the specified column as a string.

GetTimeSpan(Int32) GetTimeSpan(Int32) GetTimeSpan(Int32) GetTimeSpan(Int32)

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

GetType() GetType() GetType() GetType()

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

(Inherited from Object)
GetValue(Int32) GetValue(Int32) GetValue(Int32) 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[]) GetValues(Object[]) GetValues(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() InitializeLifetimeService() InitializeLifetimeService() 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) IsDBNull(Int32) IsDBNull(Int32) 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.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

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

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

Read() Read() Read() Read()

Setzt den OleDbDataReader auf den nächsten Datensatz.Advances the OleDbDataReader to the next record.

ToString() ToString() ToString() ToString()

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

(Inherited from Object)

Explizite Schnittstellenimplementierungen

IDataRecord.GetData(Int32) IDataRecord.GetData(Int32) IDataRecord.GetData(Int32) IDataRecord.GetData(Int32)

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

IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose()

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() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator()

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

Gilt für:

Siehe auch