OdbcDataReader Osztály

Definíció

Névtér:

System.Data.Odbc

Szerelvény:

System.Data.Odbc.dll

Csomag:

System.Data.Odbc v11.0.0-preview.5.26302.115

Forrás:

OdbcDataReader.cs

Lehetővé teszi, hogy egy adatforrásból csak előre beolvassa az adatsorokat. Ez az osztály nem örökölhető.

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

Öröklődés

Object

DbDataReader

OdbcDataReader

Példák

Az alábbi példa létrehoz egy OdbcConnection, egy OdbcCommandés egy OdbcDataReader. A példa végigolvassa az adatokat, és kiírja a konzolra. Végül a példa bezárja a OdbcDataReader, majd a 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

Megjegyzések

A létrehozáshoz OdbcDataReadermeg kell hívnia az ExecuteReaderOdbcCommand objektum metódusát a konstruktor közvetlen használata helyett.

Amíg a OdbcDataReader használatban van, a társított OdbcConnection szolgáltatás foglalt OdbcDataReader, és más műveletek nem hajthatóak végre a OdbcConnection másikon, csak a bezárásával. Ez a helyzet addig, amíg a Close metódust OdbcDataReader meg nem hívják. A kimeneti paramétereket például csak a hívás Closeután lehet lekérni.

Az adatok olvasása közben egy másik folyamat vagy szál által beállított eredmény módosítása látható lehet a OdbcDataReaderfelhasználó számára. A pontos viselkedés azonban az illesztőprogramtól és az időzítéstől is függ.

IsClosed és RecordsAffected ezek az egyetlen tulajdonságok, amelyeket a OdbcDataReader lezárás után hívhat meg. Előfordulhat, hogy a hívás előtt fel kell hívnia CloseRecordsAffected.

Tulajdonságok

Name	Description
Depth	Olyan értéket kap, amely az aktuális sor beágyazásának mélységét jelzi.
FieldCount	Lekéri az aktuális sor oszlopainak számát.
HasRows	Olyan értéket kap, amely jelzi, hogy a OdbcDataReader sor egy vagy több sort tartalmaz-e.
IsClosed	Azt jelzi, hogy a OdbcDataReader fájl bezárva van-e.
Item[Int32]	A megadott oszlop értékét a natív formátumban kapja meg az oszlop sorszáma alapján.
Item[String]	Lekéri a megadott oszlop értékét natív formátumban az oszlopnév alapján.
RecordsAffected	Lekéri az SQL-utasítás végrehajtásával módosított, beszúrt vagy törölt sorok számát.

Metódusok

Name	Description
Close()	Bezárja az OdbcDataReader objektumot.
GetBoolean(Int32)	A megadott oszlop értékét logikai értékként kapja meg.
GetByte(Int32)	A megadott oszlop értékét bájtként adja meg.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	A megadott oszlop eltolásából származó bájtokból álló adatfolyamot olvas be tömbként a pufferbe, az adott puffereltolástól kezdve.
GetChar(Int32)	A megadott oszlop értékét adja meg karakterként.
GetChars(Int32, Int64, Char[], Int32, Int32)	Beolvassa a megadott oszlop eltolásából származó karakterfolyamot tömbként a pufferbe, az adott puffereltolástól kezdve.
GetDataTypeName(Int32)	Lekéri a forrásadattípus nevét.
GetDate(Int32)	A megadott oszlop értékét adja meg objektumként DateTime .
GetDateTime(Int32)	A megadott oszlop értékét adja meg objektumként DateTime .
GetDecimal(Int32)	A megadott oszlop értékét adja meg objektumként Decimal .
GetDouble(Int32)	A megadott oszlop értékét dupla pontosságú lebegőpontos számként kapja meg.
GetEnumerator()	Olyan értéket IEnumerator ad vissza, amely az adatolvasó sorain keresztüli iterálásra használható.
GetFieldType(Int32)	Lekéri az Type objektum adattípusát.
GetFloat(Int32)	A megadott oszlop értékét egy pontosságú lebegőpontos számként adja meg.
GetGuid(Int32)	A megadott oszlop értékét globálisan egyedi azonosítóként (GUID) kapja meg.
GetInt16(Int32)	A megadott oszlop értékét 16 bites aláírt egész számként kapja meg.
GetInt32(Int32)	A megadott oszlop értékét 32 bites aláírt egész számként kapja meg.
GetInt64(Int32)	A megadott oszlop értékét 64 bites aláírt egész számként kapja meg.
GetName(Int32)	Lekéri a megadott oszlop nevét.
GetOrdinal(String)	Lekéri az oszlop sorszámát az oszlop nevének megadva.
GetSchemaTable()	DataTable Az oszlop metaadatait OdbcDataReaderleíró értéket ad vissza.
GetString(Int32)	Lekéri a megadott oszlop Stringértékét .
GetTime(Int32)	A megadott oszlop értékét adja meg objektumként TimeSpan .
GetValue(Int32)	Lekéri az oszlop értékét a megadott sorszámon a natív formátumában.
GetValues(Object[])	Egy objektumtömböt tölt fel az aktuális sor oszlopértékeivel.
IsDBNull(Int32)	Olyan értéket kap, amely jelzi, hogy az oszlop nem létező vagy hiányzó értékeket tartalmaz-e.
NextResult()	A kötegelt SQL-utasítások OdbcDataReader eredményeinek olvasásakor a következő eredményre lép.
Read()	OdbcDataReader A következő rekordra lép.

Lásd még

• Adatadapterek és Adatolvasók