OdbcDataReader-Klasse
Bietet ein Verfahren für das Lesen eines Vorwärtsstreams von Datenzeilen aus einer Datenquelle. Die Klasse kann nicht geerbt werden.
Namespace: System.Data.Odbc
Assembly: System.Data (in system.data.dll)
Syntax
'Declaration
Public NotInheritable Class OdbcDataReader
Inherits DbDataReader
'Usage
Dim instance As OdbcDataReader
public sealed class OdbcDataReader : DbDataReader
public ref class OdbcDataReader sealed : public DbDataReader
public final class OdbcDataReader extends DbDataReader
public final class OdbcDataReader extends DbDataReader
Hinweise
Anstelle der direkten Verwendung eines Konstruktors müssen Sie zum Erstellen eines OdbcDataReader die ExecuteReader-Methode des OdbcCommand-Objekts aufrufen.
Während der Verwendung des OdbcDataReader ist die zugeordnete OdbcConnection durch den Informationsfluss für den OdbcDataReader belegt, sodass an der OdbcConnection keine anderen Operationen ausgeführt werden können, außer diese zu schließen. Dies gilt solange, bis die Close-Methode von OdbcDataReader aufgerufen wird. Sie können z. B. keine Ausgabeparameter abrufen, bis Sie Close aufgerufen haben.
Änderungen an einem Resultset, die während des Lesens der Daten durch einen anderen Prozess oder Thread vorgenommen werden, sind für Benutzer des OdbcDataReader möglicherweise sichtbar. Das genaue Verhalten ist jedoch vom Treiber und vom Zeitpunkt abhängig.
Die IsClosed-Eigenschaft und die RecordsAffected-Eigenschaft sind die einzigen Eigenschaften, die nach dem Schließen von OdbcDataReader aufgerufen werden können. In einigen Fällen müssen Sie Close aufrufen, bevor RecordsAffected aufgerufen werden kann.
Beispiel
Im folgenden Beispiel werden eine OdbcConnection, ein OdbcCommand und ein OdbcDataReader erstellt. Im Beispiel werden die Daten gelesen und auf der Konsole ausgegeben. Abschließend wird im Beispiel der OdbcDataReader und danach die OdbcConnection geschlossen.
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
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();
}
}
Vererbungshierarchie
System.Object
System.MarshalByRefObject
System.Data.Common.DbDataReader
System.Data.Odbc.OdbcDataReader
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Plattformen
Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1
Siehe auch
Referenz
OdbcDataReader-Member
System.Data.Odbc-Namespace