OleDbDataReader Osztály

Definíció

Névtér:

System.Data.OleDb

Szerelvény:

System.Data.OleDb.dll

Csomag:

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

Forrás:

OleDbDataReader.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 OleDbDataReader sealed : System::Data::Common::DbDataReader

[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")]
public sealed class OleDbDataReader : System.Data.Common.DbDataReader

[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")>]
type OleDbDataReader = class
    inherit DbDataReader

Public NotInheritable Class OleDbDataReader
Inherits DbDataReader

Öröklődés

Object

DbDataReader

OleDbDataReader

Attribútumok

RequiresDynamicCodeAttribute

Példák

Az alábbi példa létrehoz egy OleDbConnection, egy OleDbCommandés egy OleDbDataReader. A példa végigolvassa az adatokat, és kiírja a konzolra. Végül a példa bezárja a OleDbDataReader elemet, majd a OleDbConnection.

public static void ReadData(string connectionString, string queryString)
{
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbCommand command = new OleDbCommand(queryString, connection);

        connection.Open();
        OleDbDataReader reader = command.ExecuteReader();

        while (reader.Read())
        {
            Console.WriteLine(reader[0].ToString());
        }
        reader.Close();
    }
}

Public Sub ReadData(ByVal connectionString As String, _
    ByVal queryString As String)
    Using connection As New OleDbConnection(connectionString)
        Dim command As New OleDbCommand(queryString, connection)

        connection.Open()

        Dim reader As OleDbDataReader = command.ExecuteReader()
        While reader.Read()
            Console.WriteLine(reader(0).ToString())
        End While
        reader.Close()
    End Using
End Sub

Megjegyzések

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

Mielőtt bezárja az OleDbConnectionobjektumot, először zárja be az OleDbDataReader objektumot. Zárja be az OleDbDataReader objektumot is, ha újra használni szeretne egy objektumot OleDbCommand . 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 OleDbDataReaderfelhasználó számára. A pontos viselkedés azonban az időzítéstől függ.

IsClosed és RecordsAffected ezek az egyetlen tulajdonságok, amelyeket a OleDbDataReader lezárás után hívhat meg. Bár a RecordsAffected tulajdonság elérhető, amíg létezik OleDbDataReader , mindig hívja Close meg, mielőtt visszaadja RecordsAffected az értéket, hogy garantálja a pontos visszatérési értéket.

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 OleDbDataReader sor egy vagy több sort tartalmaz-e.
IsClosed	Azt jelzi, hogy az adatolvasó 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.
VisibleFieldCount	A nem rejtett mezők OleDbDataReader számát adja meg.

Metódusok

Name	Description
Close()	Bezárja az OleDbDataReader 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 oszlopeltolásból származó bájtfolyamot beolvassa a pufferbe tömbként 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 oszlopeltolásból származó karakterfolyamot a pufferbe tömbként az adott puffereltolástól kezdve.
GetData(Int32)	Egy objektumot OleDbDataReader ad vissza a kért oszloprendhez.
GetDataTypeName(Int32)	Lekéri a forrásadattípus nevét.
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 OleDbDataReaderleíró értéket ad vissza.
GetString(Int32)	A megadott oszlop értékét sztringként adja meg.
GetTimeSpan(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 eredményeinek beolvasásakor az adatolvasót a következő eredményre lépteti.
Read()	OleDbDataReader A következő rekordra lép.

Lásd még

• Adatadapterek és Adatolvasók