Teilen über


OdbcDataReader Klasse

Definition

Bietet eine Möglichkeit zum Lesen eines Vorwärtsdatenstroms von Datenzeilen aus einer Datenquelle. Diese Klasse kann nicht geerbt werden.

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

Beispiele

Im folgenden Beispiel wird ein OdbcConnection, ein OdbcCommandund ein OdbcDataReadererstellt. Im Beispiel werden die Daten gelesen und in die Konsole geschrieben. Schließlich schließt das Beispiel die OdbcDataReaderund dann die OdbcConnection.

public static void ReadData(string connectionString)
{
    string queryString = "SELECT DISTINCT CustomerID FROM Orders";

    using (OdbcConnection connection = new OdbcConnection(connectionString))
    {
        OdbcCommand command = new OdbcCommand(queryString, connection);

        connection.Open();

        // Execute the DataReader and access the data.
        OdbcDataReader reader = command.ExecuteReader();
        while (reader.Read())
        {
            Console.WriteLine("CustomerID={0}", reader[0]);
        }

        // Call Close when done reading.
        reader.Close();
    }
}
Public Sub ReadData(ByVal connectionString As String)
    Dim queryString As String = "SELECT DISTINCT CustomerID FROM Orders"

    Using connection As New OdbcConnection(connectionString)
        Dim command As New OdbcCommand(queryString, connection)

        connection.Open()

        Dim reader As OdbcDataReader = command.ExecuteReader()

        While reader.Read()
            Console.WriteLine("CustomerID={0}", reader(0).ToString)
        End While

        ' Call Close when done reading.
        reader.Close()
    End Using
End Sub

Hinweise

Um eine OdbcDataReaderzu erstellen, müssen Sie die ExecuteReader-Methode des OdbcCommand-Objekts aufrufen, anstatt direkt einen Konstruktor zu verwenden.

Während die OdbcDataReader verwendet wird, ist die zugeordnete OdbcConnection beschäftigt, um die OdbcDataReaderzu bedienen, und es können keine anderen Vorgänge für die OdbcConnection ausgeführt werden, die nicht das Schließen der OdbcConnection. Dies ist der Fall, bis die Close Methode des OdbcDataReader aufgerufen wird. Sie können z. B. erst nach dem Aufruf CloseAusgabeparameter abrufen.

Änderungen, die an einem Resultset durch einen anderen Prozess oder Thread vorgenommen wurden, während Daten gelesen werden, sind möglicherweise für den Benutzer der OdbcDataReadersichtbar. Das genaue Verhalten ist jedoch sowohl treiber- als auch zeitlich abhängig.

IsClosed und RecordsAffected sind die einzigen Eigenschaften, die Sie aufrufen können, nachdem die OdbcDataReader geschlossen wurde. Manchmal müssen Sie Close anrufen, bevor Sie RecordsAffectedaufrufen können.

Eigenschaften

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 die OdbcDataReader eine oder mehrere Zeilen enthält.

IsClosed

Gibt an, ob die OdbcDataReader geschlossen ist.

Item[Int32]

Ruft den Wert der angegebenen Spalte im systemeigenen Format ab, wenn die Spalte Ordnungszahl angegeben ist.

Item[String]

Ruft den Wert der angegebenen Spalte im systemeigenen Format ab, das den Spaltennamen enthält.

RecordsAffected

Ruft die Anzahl der Zeilen geändert, eingefügt oder gelöscht durch Ausführung der SQL-Anweisung ab.

VisibleFieldCount

Ruft die Anzahl der Felder in der DbDataReader ab, die nicht ausgeblendet sind.

(Geerbt von DbDataReader)

Methoden

Close()

Schließt das OdbcDataReader-Objekt.

CloseAsync()

Schließt das DbDataReader-Objekt asynchron.

(Geerbt von DbDataReader)
CreateObjRef(Type)

Erstellt ein Objekt, das alle relevanten Informationen enthält, die zum Generieren eines Proxys erforderlich sind, der für die Kommunikation mit einem Remoteobjekt verwendet wird.

(Geerbt von MarshalByRefObject)
Dispose()

Gibt alle Ressourcen frei, die von der aktuellen Instanz der DbDataReader Klasse verwendet werden.

(Geerbt von DbDataReader)
Dispose(Boolean)

Gibt die nicht verwalteten Ressourcen frei, die vom DbDataReader verwendet werden, und gibt optional die verwalteten Ressourcen frei.

(Geerbt von DbDataReader)
DisposeAsync()

Gibt asynchron alle Ressourcen frei, die von der aktuellen Instanz der DbDataReader Klasse verwendet werden.

(Geerbt von DbDataReader)
Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
Finalize()

Ermöglicht es dem Objekt, Ressourcen freizugeben und andere Bereinigungsvorgänge auszuführen, bevor es von der Garbage Collection erneut beansprucht wird.

GetBoolean(Int32)

Ruft den Wert der angegebenen Spalte als booleschen Wert ab.

GetByte(Int32)

Ruft den Wert der angegebenen Spalte als Byte ab.

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

Liest einen Bytestrom aus dem angegebenen Spaltenoffset in den Puffer als Array, beginnend mit dem jeweiligen Pufferoffset.

GetChar(Int32)

Ruft den Wert der angegebenen Spalte als Zeichen ab.

GetChars(Int32, Int64, Char[], Int32, Int32)

Liest einen Datenstrom von Zeichen aus dem angegebenen Spaltenoffset in den Puffer als Array ab dem jeweiligen Pufferoffset.

GetColumnSchemaAsync(CancellationToken)

Dies ist die asynchrone Version von GetColumnSchema(DbDataReader). Anbieter sollten mit einer geeigneten Implementierung außer Kraft setzen. Die cancellationToken können optional berücksichtigt werden. Die Standardimplementierung ruft den synchronen GetColumnSchema(DbDataReader) Aufruf auf und gibt eine abgeschlossene Aufgabe zurück. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn eine bereits abgebrochene cancellationTokenübergeben wurde. Ausnahmen, die von GetColumnSchema(DbDataReader) ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft kommuniziert.

(Geerbt von DbDataReader)
GetData(Int32)

Gibt einen IDataReader für die angegebene Spalten-Ordnungszahl zurück.

GetData(Int32)

Gibt einen geschachtelten Datenleser für die angeforderte Spalte zurück.

(Geerbt von DbDataReader)
GetDataTypeName(Int32)

Ruft den Namen des Quelldatentyps ab.

GetDate(Int32)

Ruft den Wert der angegebenen Spalte als DateTime -Objekt ab.

GetDateTime(Int32)

Ruft den Wert der angegebenen Spalte als DateTime -Objekt ab.

GetDbDataReader(Int32)

Gibt ein DbDataReader -Objekt für die angeforderte Spalten-Ordnungszahl zurück, die mit einer anbieterspezifischen Implementierung überschrieben werden kann.

(Geerbt von DbDataReader)
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, der zum Durchlaufen der Zeilen im Datenleser verwendet werden kann.

GetFieldType(Int32)

Ruft die Type ab, die der Datentyp des Objekts ist.

GetFieldValue<T>(Int32)

Ruft den Wert der angegebenen Spalte als angeforderten Typ ab.

(Geerbt von DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)

Ruft asynchron den Wert der angegebenen Spalte als angeforderten Typ ab.

(Geerbt von DbDataReader)
GetFieldValueAsync<T>(Int32)

Ruft asynchron den Wert der angegebenen Spalte 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 (GUID) ab.

GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetInt16(Int32)

Ruft den Wert der angegebenen Spalte als eine 16-Bit-ganzzahlige Vorzeichen ab.

GetInt32(Int32)

Ruft den Wert der angegebenen Spalte als 32-Bit-ganzzahlige Vorzeichen ab.

GetInt64(Int32)

Ruft den Wert der angegebenen Spalte als ganze 64-Bit-Ganzzahl ab.

GetLifetimeService()
Veraltet.

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinie für diese Instanz steuert.

(Geerbt von MarshalByRefObject)
GetName(Int32)

Ruft den Namen der angegebenen Spalte ab.

GetOrdinal(String)

Ruft die Spalten-Ordnungszahl ab, wobei der Name der Spalte angegeben ist.

GetProviderSpecificFieldType(Int32)

Ruft den anbieterspezifischen Typ der angegebenen Spalte ab.

(Geerbt von DbDataReader)
GetProviderSpecificValue(Int32)

Ruft den Wert der angegebenen Spalte als Instanz eines anbieterspezifischen Typs ab.

(Geerbt von DbDataReader)
GetProviderSpecificValues(Object[])

Ruft alle anbieterspezifischen Attributspalten in der Auflistung für die aktuelle Zeile ab.

(Geerbt von DbDataReader)
GetSchemaTable()

Gibt einen DataTable zurück, der die Spaltenmetadaten des OdbcDataReaderbeschreibt.

GetSchemaTableAsync(CancellationToken)

Dies ist die asynchrone Version von GetSchemaTable(). Anbieter sollten mit einer geeigneten Implementierung außer Kraft setzen. Die cancellationToken können optional berücksichtigt werden. Die Standardimplementierung ruft den synchronen GetSchemaTable() Aufruf auf und gibt eine abgeschlossene Aufgabe zurück. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn eine bereits abgebrochene cancellationTokenübergeben wurde. Ausnahmen, die von GetSchemaTable() ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft kommuniziert.

(Geerbt von DbDataReader)
GetStream(Int32)

Ruft einen Datenstrom ab, um Daten aus der angegebenen Spalte abzurufen.

(Geerbt von DbDataReader)
GetString(Int32)

Ruft den Wert der angegebenen Spalte als Stringab.

GetTextReader(Int32)

Ruft einen Textleser ab, um Daten aus der Spalte abzurufen.

(Geerbt von DbDataReader)
GetTime(Int32)

Ruft den Wert der angegebenen Spalte als TimeSpan -Objekt ab.

GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
GetValue(Int32)

Ruft den Wert der Spalte am angegebenen Ordinal im systemeigenen Format ab.

GetValues(Object[])

Füllt ein Array von Objekten mit den Spaltenwerten der aktuellen Zeile auf.

InitializeLifetimeService()
Veraltet.

Ruft ein Lebensdauerdienstobjekt ab, um die Lebensdauerrichtlinie für diese Instanz zu steuern.

(Geerbt von MarshalByRefObject)
IsDBNull(Int32)

Ruft einen Wert ab, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält.

IsDBNullAsync(Int32, CancellationToken)

Ruft asynchron einen Wert ab, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält.

(Geerbt von DbDataReader)
IsDBNullAsync(Int32)

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 der aktuellen Object.

(Geerbt von Object)
MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.

(Geerbt von MarshalByRefObject)
NextResult()

Führt die OdbcDataReader zum nächsten Ergebnis durch, wenn die Ergebnisse von SQL-Batchanweisungen gelesen werden.

NextResultAsync()

Wechselt den Leser asynchron zum nächsten Ergebnis, wenn die Ergebnisse einer Reihe von Anweisungen gelesen werden.

(Geerbt von DbDataReader)
NextResultAsync(CancellationToken)

Wechselt den Leser asynchron zum nächsten Ergebnis, wenn die Ergebnisse einer Reihe von Anweisungen gelesen werden.

(Geerbt von DbDataReader)
Read()

Wechselt die OdbcDataReader zum nächsten Datensatz.

ReadAsync()

Wechselt den Leser asynchron zum nächsten Datensatz in einem Resultset.

(Geerbt von DbDataReader)
ReadAsync(CancellationToken)

Wechselt den Leser asynchron zum 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 Mitglieds finden Sie unter 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 Ressourcen frei, die von der aktuellen Instanz der OdbcDataReader Klasse verwendet werden.

IEnumerable.GetEnumerator()

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

Gibt einen Enumerator zurück, der eine Auflistung durchläuft.

Erweiterungsmethoden

CanGetColumnSchema(DbDataReader)

Ruft einen Wert ab, der angibt, ob ein DbDataReader ein Spaltenschema abrufen kann.

GetColumnSchema(DbDataReader)

Ruft das Spaltenschema (DbColumn -Auflistung) für eine DbDataReaderab.

GetBoolean(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als booleschen Wert ab.

GetByte(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als Byte ab.

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

Liest eine angegebene Anzahl von Bytes aus der angegebenen Spalte beginnend mit einem angegebenen Index und schreibt sie in einen Puffer, der an einer angegebenen Position im Puffer beginnt.

GetChar(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als einzelnes Zeichen ab.

GetChars(DbDataReader, String, Int64, Char[], Int32, Int32)

Liest eine angegebene Anzahl von Zeichen aus einer angegebenen Spalte ab einem angegebenen Index und schreibt sie in einen Puffer, der an einer angegebenen Position beginnt.

GetData(DbDataReader, String)

Gibt einen geschachtelten Datenleser für die angeforderte Spalte zurück.

GetDataTypeName(DbDataReader, String)

Ruft den Namen des Datentyps der angegebenen Spalte ab.

GetDateTime(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als DateTime -Objekt ab.

GetDecimal(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als Decimalab.

GetDouble(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als Gleitkommazahl mit doppelter Genauigkeit ab.

GetFieldType(DbDataReader, String)

Ruft den Datentyp der angegebenen Spalte ab.

GetFieldValue<T>(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als angeforderten Typ ab.

GetFieldValueAsync<T>(DbDataReader, String, CancellationToken)

Ruft asynchron den Wert der angegebenen Spalte als angeforderten Typ ab.

GetFloat(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als Gleitkommazahl mit einfacher Genauigkeit ab.

GetGuid(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als global eindeutigen Bezeichner (GUID) ab.

GetInt16(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als eine 16-Bit-ganzzahlige Vorzeichen ab.

GetInt32(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als 32-Bit-ganzzahlige Vorzeichen ab.

GetInt64(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als ganze 64-Bit-Ganzzahl ab.

GetProviderSpecificFieldType(DbDataReader, String)

Ruft den anbieterspezifischen Typ der angegebenen Spalte ab.

GetProviderSpecificValue(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als Instanz eines anbieterspezifischen Typs ab.

GetStream(DbDataReader, String)

Ruft einen Datenstrom ab, um Daten aus der angegebenen Spalte abzurufen.

GetString(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als Instanz von Stringab.

GetTextReader(DbDataReader, String)

Ruft einen Textleser ab, um Daten aus der Spalte abzurufen.

GetValue(DbDataReader, String)

Ruft den Wert der angegebenen Spalte als Instanz von Objectab.

IsDBNull(DbDataReader, String)

Ruft einen Wert ab, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält.

IsDBNullAsync(DbDataReader, String, CancellationToken)

Ruft asynchron einen Wert ab, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält.

Cast<TResult>(IEnumerable)

Wandelt die Elemente eines IEnumerable in den angegebenen Typ um.

OfType<TResult>(IEnumerable)

Filtert die Elemente einer IEnumerable basierend auf einem angegebenen Typ.

AsParallel(IEnumerable)

Aktiviert die Parallelisierung einer Abfrage.

AsQueryable(IEnumerable)

Wandelt eine IEnumerable in eine IQueryableum.

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguriert, wie auf die von einem asynchronen Einweg zurückgegebenen Aufgaben gewartet wird.

Gilt für:

Weitere Informationen