OleDbDataReader Třída

Definice

Poskytuje způsob čtení datového proudu řádků dat ze zdroje dat, který je jen dopředný. Tuto třídu nelze dědit.

public ref class OleDbDataReader sealed : System::Data::Common::DbDataReader
public ref class OleDbDataReader sealed : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader
public sealed class OleDbDataReader : System.Data.Common.DbDataReader
public sealed class OleDbDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader
type OleDbDataReader = class
    inherit DbDataReader
type OleDbDataReader = class
    inherit MarshalByRefObject
    interface IDataReader
    interface IDisposable
    interface IDataRecord
    interface IEnumerable
Public NotInheritable Class OleDbDataReader
Inherits DbDataReader
Public NotInheritable Class OleDbDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerable
Dědičnost
OleDbDataReader
Dědičnost
Dědičnost
OleDbDataReader
Implementuje

Příklady

Následující příklad vytvoří OleDbConnection, a OleDbCommandOleDbDataReader. Příklad čte data a zapisuje je do konzoly. Nakonec příklad zavře OleDbDataReader a pak 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

Poznámky

Chcete-li vytvořit OleDbDataReader, je nutné volat ExecuteReader metodu objektu OleDbCommand namísto přímého použití konstruktoru.

Než zavřete OleDbConnectionobjekt , nejprve objekt zavřete OleDbDataReader . Pokud chcete objekt znovu použítOleDbCommand, musíte objekt také zavřítOleDbDataReader. Například nelze načíst výstupní parametry, dokud nevoláte Close.

Změny provedené v sadě výsledků jiným procesem nebo vláknem během čtení dat můžou být viditelné uživateli objektu OleDbDataReader. Přesné chování je však závislé na načasování.

IsClosed a RecordsAffected jsou jediné vlastnosti, které můžete volat po OleDbDataReader zavření. RecordsAffected I když vlastnost může být přístupná, dokud OleDbDataReader existuje, vždy volejte Close před vrácením hodnoty, RecordsAffected aby se zajistila přesná návratová hodnota.

Vlastnosti

Depth

Získá hodnotu, která označuje hloubku vnoření pro aktuální řádek.

FieldCount

Získá počet sloupců v aktuálním řádku.

HasRows

Získá hodnotu, která označuje, zda OleDbDataReader obsahuje jeden nebo více řádků.

IsClosed

Označuje, jestli je čtečka dat zavřená.

Item[Int32]

Získá hodnotu zadaného sloupce v jeho nativním formátu vzhledem k pořadové číslo sloupci.

Item[String]

Získá hodnotu zadaného sloupce v jeho nativním formátu vzhledem k názvu sloupce.

RecordsAffected

Získá počet řádků změněných, vložených nebo odstraněných spuštěním příkazu SQL.

VisibleFieldCount

Získá počet polí v objektu OleDbDataReader , která nejsou skryta.

Metody

Close()

OleDbDataReader Zavře objekt.

CloseAsync()

Asynchronně zavře DbDataReader objekt.

(Zděděno od DbDataReader)
CreateObjRef(Type)

Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy sloužící ke komunikaci se vzdáleným objektem.

(Zděděno od MarshalByRefObject)
Dispose()

Uvolní všechny prostředky používané aktuální instancí DbDataReader třídy .

(Zděděno od DbDataReader)
Dispose(Boolean)

Uvolní nespravované prostředky používané nástrojem DbDataReader a volitelně uvolní spravované prostředky.

(Zděděno od DbDataReader)
DisposeAsync()

Asynchronně uvolní všechny prostředky používané aktuální instancí DbDataReader třídy .

(Zděděno od DbDataReader)
Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
Finalize()

Umožňuje objektu pokusit se uvolnit prostředky a provést další operace čištění předtím, než je uvolněna uvolňováním paměti.

GetBoolean(Int32)

Získá hodnotu zadaného sloupce jako logická hodnota.

GetByte(Int32)

Získá hodnotu zadaného sloupce jako bajt.

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

Načte proud bajtů ze zadaného posunu sloupce do vyrovnávací paměti jako pole počínaje daným posunem vyrovnávací paměti.

GetChar(Int32)

Získá hodnotu zadaného sloupce jako znak.

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

Načte stream znaků ze zadaného posunu sloupce do vyrovnávací paměti jako pole počínaje daným posunem vyrovnávací paměti.

GetColumnSchemaAsync(CancellationToken)

Toto je asynchronní verze nástroje GetColumnSchema(DbDataReader). Poskytovatelé by měli přepsat příslušnou implementací. Volitelně cancellationToken může být respektována. Výchozí implementace vyvolá synchronní GetColumnSchema(DbDataReader) volání a vrátí dokončenou úlohu. Výchozí implementace vrátí zrušenou úlohu, pokud byla předána již zrušená cancellationTokenúloha . Výjimky vyvolané nástrojem GetColumnSchema(DbDataReader) budou oznámeny prostřednictvím vrácené vlastnosti Task Exception (Výjimka úkolu).

(Zděděno od DbDataReader)
GetData(Int32)

OleDbDataReader Vrátí objekt pro pořadové číslo požadovaného sloupce.

GetDataTypeName(Int32)

Získá název zdrojového datového typu.

GetDateTime(Int32)

Získá hodnotu zadaného sloupce jako DateTime objekt.

GetDbDataReader(Int32)

DbDataReader Vrátí objekt pro pořadové číslo požadovaného sloupce, který lze přepsat implementací specifickou pro zprostředkovatele.

(Zděděno od DbDataReader)
GetDecimal(Int32)

Získá hodnotu zadaného sloupce jako Decimal objekt.

GetDouble(Int32)

Získá hodnotu zadaného sloupce jako číslo s plovoucí desetinou čárkou s dvojitou přesností.

GetEnumerator()

Vrátí hodnotu IEnumerator , která se dá použít k iteraci řádky ve čtečce dat.

GetFieldType(Int32)

Type Získá objekt , který je datový typ objektu.

GetFieldValue<T>(Int32)

Získá hodnotu zadaného sloupce jako požadovaný typ.

(Zděděno od DbDataReader)
GetFieldValueAsync<T>(Int32)

Asynchronně získá hodnotu zadaného sloupce jako požadovaný typ.

(Zděděno od DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)

Asynchronně získá hodnotu zadaného sloupce jako požadovaný typ.

(Zděděno od DbDataReader)
GetFloat(Int32)

Získá hodnotu zadaného sloupce jako číslo s plovoucí desetinou čárkou s jednou přesností.

GetGuid(Int32)

Získá hodnotu zadaného sloupce jako globálně jedinečný identifikátor (GUID).

GetHashCode()

Slouží jako výchozí hashovací funkce.

(Zděděno od Object)
GetInt16(Int32)

Získá hodnotu zadaného sloupce jako 16bitové podepsané celé číslo.

GetInt32(Int32)

Získá hodnotu zadaného sloupce jako 32bitové podepsané celé číslo.

GetInt64(Int32)

Získá hodnotu zadaného sloupce jako 64bitové podepsané celé číslo.

GetLifetimeService()
Zastaralé.

Načte aktuální životnost objektu služby, který řídí zásady životnosti pro tuto instanci.

(Zděděno od MarshalByRefObject)
GetName(Int32)

Získá název zadaného sloupce.

GetOrdinal(String)

Získá pořadové číslo sloupce vzhledem k názvu sloupce.

GetProviderSpecificFieldType(Int32)

Získá typ konkrétního zprostředkovatele zadaného sloupce.

(Zděděno od DbDataReader)
GetProviderSpecificValue(Int32)

Získá hodnotu zadaného sloupce jako instanci typu specifického pro zprostředkovatele.

(Zděděno od DbDataReader)
GetProviderSpecificValues(Object[])

Získá všechny sloupce atributů specifické pro poskytovatele v kolekci pro aktuální řádek.

(Zděděno od DbDataReader)
GetSchemaTable()

Vrátí hodnotu DataTable , která popisuje metadata sloupce objektu OleDbDataReader.

GetSchemaTableAsync(CancellationToken)

Toto je asynchronní verze nástroje GetSchemaTable(). Poskytovatelé by měli přepsat příslušnou implementací. Volitelně cancellationToken může být respektována. Výchozí implementace vyvolá synchronní GetSchemaTable() volání a vrátí dokončenou úlohu. Výchozí implementace vrátí zrušenou úlohu, pokud byla předána již zrušená cancellationTokenúloha . Výjimky vyvolané nástrojem GetSchemaTable() budou oznámeny prostřednictvím vrácené vlastnosti Task Exception (Výjimka úkolu).

(Zděděno od DbDataReader)
GetStream(Int32)

Získá datový proud pro načtení dat ze zadaného sloupce.

(Zděděno od DbDataReader)
GetString(Int32)

Získá hodnotu zadaného sloupce jako řetězec.

GetTextReader(Int32)

Získá čtečku textu pro načtení dat ze sloupce.

(Zděděno od DbDataReader)
GetTimeSpan(Int32)

Získá hodnotu zadaného sloupce jako TimeSpan objekt.

GetType()

Type Získá z aktuální instance.

(Zděděno od Object)
GetValue(Int32)

Získá hodnotu sloupce v zadaném pořadovém čísla v jeho nativním formátu.

GetValues(Object[])

Naplní pole objektů hodnotami sloupců aktuálního řádku.

InitializeLifetimeService()
Zastaralé.

Získá životnost objektu služby, který řídí zásady životnosti pro tuto instanci.

(Zděděno od MarshalByRefObject)
IsDBNull(Int32)

Získá hodnotu, která označuje, zda sloupec obsahuje neexistující nebo chybějící hodnoty.

IsDBNullAsync(Int32)

Asynchronně získá hodnotu, která označuje, zda sloupec obsahuje neexistující nebo chybějící hodnoty.

(Zděděno od DbDataReader)
IsDBNullAsync(Int32, CancellationToken)

Asynchronně získá hodnotu, která označuje, zda sloupec obsahuje neexistující nebo chybějící hodnoty.

(Zděděno od DbDataReader)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Objectsouboru .

(Zděděno od Object)
MemberwiseClone(Boolean)

Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu.

(Zděděno od MarshalByRefObject)
NextResult()

Při čtení výsledků dávkových příkazů SQL posune čtečku dat na další výsledek.

NextResultAsync()

Při čtení výsledků dávky příkazů asynchronně posune čtenáře na další výsledek.

(Zděděno od DbDataReader)
NextResultAsync(CancellationToken)

Při čtení výsledků dávky příkazů asynchronně posune čtenáře na další výsledek.

(Zděděno od DbDataReader)
Read()

Přejde na OleDbDataReader další záznam.

ReadAsync()

Asynchronně posune čtenáře na další záznam v sadě výsledků dotazu.

(Zděděno od DbDataReader)
ReadAsync(CancellationToken)

Asynchronně posune čtenáře na další záznam v sadě výsledků dotazu.

(Zděděno od DbDataReader)
ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)

Explicitní implementace rozhraní

IDataRecord.GetData(Int32)

Vrátí hodnotu IDataReader pro zadanou řadovou číslo sloupce.

IDataRecord.GetData(Int32)

Popis tohoto člena najdete v tématu GetData(Int32).

(Zděděno od DbDataReader)
IDisposable.Dispose()

Toto rozhraní API podporuje produktovou infrastrukturu a není určené k použití přímo z uživatelského kódu.

Uvolní prostředky používané aktuální instancí třídy OleDbDataReader.

IEnumerable.GetEnumerator()

Vrací enumerátor procházející kolekci.

Metody rozšíření

CanGetColumnSchema(DbDataReader)

Získá hodnotu, která označuje, zda DbDataReader lze získat schéma sloupce.

GetColumnSchema(DbDataReader)

Získá schéma sloupce (DbColumn kolekci DbDataReader) pro .

Cast<TResult>(IEnumerable)

Přetypuje prvky objektu na IEnumerable zadaný typ.

OfType<TResult>(IEnumerable)

Filtruje prvky objektu IEnumerable na základě zadaného typu.

AsParallel(IEnumerable)

Umožňuje paralelizaci dotazu.

AsQueryable(IEnumerable)

Převede objekt na IEnumerableIQueryable.

Platí pro

Viz také