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

Beispiele

Im folgenden Beispiel werden ein OdbcConnection, ein OdbcCommandund OdbcDataReaderein erstellt.The following example creates an OdbcConnection, an OdbcCommand, and an OdbcDataReader. 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 OdbcDataReaderund dann das. OdbcConnectionFinally, the example closes the OdbcDataReader, and then the 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 OdbcDataReadermuss die ExecuteReader -Methode des OdbcCommand -Objekts aufgerufen werden, anstatt direkt einen Konstruktor zu verwenden.To create an OdbcDataReader, you must call the ExecuteReader method of the OdbcCommand object, instead of directly using a constructor.

Während der OdbcDataReader verwendet wird, OdbcConnection ist die zugeordnete für die OdbcDataReaderVerwendung von ausgelastet, und es können keine anderen Vorgänge auf OdbcConnection dem anderen ausgeführt werden, als es zu schließen.While the OdbcDataReader is being used, the associated OdbcConnection is busy serving the OdbcDataReader, and no other operations can be performed on the OdbcConnection other than closing it. Dies ist der Fall, bis Close die-Methode OdbcDataReader von aufgerufen wird.This is the case until the Close method of the OdbcDataReader is called. Beispielsweise können Sie erst dann Ausgabeparameter abrufen, nachdem Sie Closeaufgerufen haben.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 OdbcDataReadermö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 OdbcDataReader. Allerdings ist das genaue Verhalten sowohl vom Treiber als auch von der zeitlichen Steuerung abhängig.However, the precise behavior is both driver and timing dependent.

IsClosedund RecordsAffected sind die einzigen Eigenschaften, die Sie nach dem OdbcDataReader schließen von aufzurufen können.IsClosed and RecordsAffected are the only properties that you can call after the OdbcDataReader is closed. Manchmal müssen Sie anrufen Close , bevor Sie den Befehl ausführen RecordsAffectedkönnen.Sometimes, you must call Close before you can call RecordsAffected.

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 OdbcDataReader eine oder mehrere Zeilen enthält.Gets a value that indicates whether the OdbcDataReader contains one or more rows.

IsClosed

Gibt an, ob OdbcDataReader geschlossen ist.Indicates whether the OdbcDataReader 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.

Methoden

Close()

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

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

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.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 jeweiligen 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 particular 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 beginnend am jeweiligen Pufferoffset einen Stream von Zeichen aus dem angegebenen Spaltenoffset als Array in den Puffer.Reads a stream of characters from the specified column offset into the buffer as an array, starting at the particular buffer offset.

GetData(Int32)

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

GetDataTypeName(Int32)

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

GetDate(Int32)

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

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)

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.

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

GetHashCode()

Dient als die Standard-HashfunktionServes 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.

GetSchemaTable()

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

GetString(Int32)

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

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

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 OdbcDataReader beim Lesen der Ergebnisse von SQL-Batchanweisungen auf das nächste Ergebnis.Advances the OdbcDataReader to the next result when reading the results of batch SQL statements.

Read()

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

ToString()

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

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

IDisposable.Dispose()

Gibt alle von der aktuellen Instanz der OdbcDataReader-Klasse verwendeten Ressourcen frei.Releases all resources used by the current instance of the OdbcDataReader class.

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