OdbcDataReader Klasse

Definition

Bietet ein Verfahren für das Lesen eines Vorwärtsstreams von Datenzeilen aus einer Datenquelle. Diese Klasse kann nicht vererbt 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
OdbcDataReader
Vererbung
Vererbung
OdbcDataReader
Implementiert

Beispiele

Im folgenden Beispiel werden ein OdbcConnection, ein OdbcCommandund ein OdbcDataReadererstellt. Im Beispiel werden die Daten gelesen und in die Konsole geschrieben. Schließlich schließt das Beispiel die OdbcDataReader- und 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

Zum Erstellen eines OdbcDataReadermüssen Sie die ExecuteReader -Methode des OdbcCommand -Objekts aufrufen, anstatt direkt einen Konstruktor zu verwenden.

Während der OdbcDataReader verwendet wird, ist der zugeordnete OdbcConnection beschäftigt, um die OdbcDataReaderzu bedienen, und es können keine anderen Vorgänge als das OdbcConnection Schließen ausgeführt werden. Dies ist der Fall, bis die Close Methode des OdbcDataReader aufgerufen wird. Beispielsweise können Sie erst nach dem Aufrufen Closevon Ausgabeparametern abrufen.

Während des Lesens von Daten von einem anderen Prozess oder Thread an einem Resultset vorgenommene Änderungen sind für den Benutzer von OdbcDataReader möglicherweise sichtbar. Das genaue Verhalten ist jedoch sowohl vom Treiber als auch vom Zeitpunkt abhängig.

IsClosed und RecordsAffected sind die einzigen Eigenschaften, die nach dem Schließen von OdbcDataReader aufgerufen werden können. Manchmal müssen Sie aufrufen Close , bevor Sie aufrufen RecordsAffectedkö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 OdbcDataReader eine oder mehrere Zeilen enthält.

IsClosed

Gibt an, ob OdbcDataReader geschlossen ist.

Item[Int32]

Ruft bei angegebener Spaltenordnungszahl den Wert der angegebenen Spalte im systemeigenen Format ab.

Item[String]

Ruft bei angegebenem Spaltennamen den Wert der angegebenen Spalte im systemeigenen Format ab.

RecordsAffected

Ruft die Anzahl der durch die Ausführung der SQL-Anweisung geänderten, eingefügten oder gelöschten Zeilen ab.

VisibleFieldCount

Ruft die Anzahl der nicht ausgeblendeten Felder im DbDataReader ab.

(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 mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.

(Geerbt von MarshalByRefObject)
Dispose()

Gibt alle von der aktuellen Instanz der DbDataReader-Klasse verwendeten Ressourcen frei.

(Geerbt von DbDataReader)
Dispose(Boolean)

Gibt die von DbDataReader verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.

(Geerbt von DbDataReader)
DisposeAsync()

Gibt alle von der aktuellen Instanz der DbDataReader-Klasse verwendeten Ressourcen asynchron frei.

(Geerbt von DbDataReader)
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

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

GetBoolean(Int32)

Ruft den Wert der angegebenen Spalte als booleschen Wert ab.

GetByte(Int32)

Ruft den Wert der angegebenen Spalte als ein Byte ab.

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

Liest beginnend am jeweiligen Pufferoffset einen Stream von Bytes aus dem angegebenen Spaltenoffset als Array in den Puffer.

GetChar(Int32)

Ruft den Wert der angegebenen Spalte als Zeichen ab.

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

Liest beginnend am jeweiligen Pufferoffset einen Stream von Zeichen aus dem angegebenen Spaltenoffset als Array in den Puffer.

GetColumnSchemaAsync(CancellationToken)

Dies ist die asynchrone Version von GetColumnSchema(DbDataReader). Anbieter sollten mit einer entsprechenden Implementierung überschreiben. Das cancellationToken kann optional berücksichtigt werden. Die Standardimplementierung ruft den asynchronen GetColumnSchema(DbDataReader)-Aufruf auf und gibt eine abgeschlossene Aufgabe zurück. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen cancellationToken erhalten wird. Die Ausnahmen, die von GetColumnSchema(DbDataReader) ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt.

(Geerbt von DbDataReader)
GetData(Int32)

Gibt einen IDataReader für die angegebene Spaltenordnungszahl zurück.

GetData(Int32)

Gibt einen verschachtelten Datenreader 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 Spaltenordnungszahl zurück, das 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, mit dem die Zeilen im Datenleser durchlaufen werden können.

GetFieldType(Int32)

Ruft den Type ab, der den Datentyp des Objekts darstellt.

GetFieldValue<T>(Int32)

Ruft den Wert der angegebenen Spalte als angeforderten Typ ab.

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

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

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

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

GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetInt16(Int32)

Ruft den Wert der angegebenen Spalte als 16-Bit-Ganzzahl mit Vorzeichen ab.

GetInt32(Int32)

Ruft den Wert der angegebenen Spalte als ganze Zahl mit Vorzeichen und einer Länge von 32 Bit ab.

GetInt64(Int32)

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

GetLifetimeService()
Veraltet.

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

(Geerbt von MarshalByRefObject)
GetName(Int32)

Ruft den Namen der angegebenen Spalte ab.

GetOrdinal(String)

Ruft bei angegebenem Spaltennamen die Ordnungszahl der Spalte ab.

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 der aktuellen Zeile ab.

(Geerbt von DbDataReader)
GetSchemaTable()

Gibt eine DataTable zurück, die die Spaltenmetadaten des OdbcDataReader beschreibt.

GetSchemaTableAsync(CancellationToken)

Dies ist die asynchrone Version von GetSchemaTable(). Anbieter sollten mit einer entsprechenden Implementierung überschreiben. Das cancellationToken kann optional berücksichtigt werden. Die Standardimplementierung ruft den asynchronen GetSchemaTable()-Aufruf auf und gibt eine abgeschlossene Aufgabe zurück. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen cancellationToken erhalten wird. Die Ausnahmen, die von GetSchemaTable() ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt.

(Geerbt von DbDataReader)
GetStream(Int32)

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

(Geerbt von DbDataReader)
GetString(Int32)

Ruft den Wert der angegebenen Spalte als String ab.

GetTextReader(Int32)

Ruft einen Textreader zum Auslesen von Daten aus der Spalte ab.

(Geerbt von DbDataReader)
GetTime(Int32)

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

GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
GetValue(Int32)

Ruft den Wert der Spalte an der angegebenen Ordnungszahl im systemeigenen Format ab.

GetValues(Object[])

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

InitializeLifetimeService()
Veraltet.

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.

(Geerbt von MarshalByRefObject)
IsDBNull(Int32)

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

IsDBNullAsync(Int32)

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

(Geerbt von DbDataReader)
IsDBNullAsync(Int32, CancellationToken)

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

(Geerbt von Object)
MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.

(Geerbt von MarshalByRefObject)
NextResult()

Setzt den OdbcDataReader beim Lesen der Ergebnisse von SQL-Batchanweisungen auf das nächste Ergebnis.

NextResultAsync()

Setzt den Datenreader beim Lesen der Ergebnisse von Batchanweisungen asynchron auf das nächste Ergebnis.

(Geerbt von DbDataReader)
NextResultAsync(CancellationToken)

Setzt den Datenreader beim Lesen der Ergebnisse von Batchanweisungen asynchron auf das nächste Ergebnis.

(Geerbt von DbDataReader)
Read()

Setzt den OdbcDataReader auf den nächsten Datensatz.

ReadAsync()

Setzt den Reader asynchron auf den nächsten Datensatz in einem Resultset.

(Geerbt von DbDataReader)
ReadAsync(CancellationToken)

Setzt den Reader asynchron auf den 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 Elements 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 von der aktuellen Instanz der OdbcDataReader-Klasse verwendeten Ressourcen frei.

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-Objekt ein Spaltenschema haben kann.

GetColumnSchema(DbDataReader)

Ruft das Spaltenschema für ein DbDataReader-Objekt ab (DbColumn-Auflistung).

Cast<TResult>(IEnumerable)

Wandelt die Elemente eines IEnumerable in den angegebenen Typ um

OfType<TResult>(IEnumerable)

Filtert die Elemente eines IEnumerable anhand eines angegebenen Typs

AsParallel(IEnumerable)

Ermöglicht die Parallelisierung einer Abfrage.

AsQueryable(IEnumerable)

Konvertiert einen IEnumerable in einen IQueryable.

Gilt für:

Weitere Informationen