OleDbDataReader Třída

Reference

Definice

Obor názvů:: System.Data.OleDb

Sestavení:: System.Data.OleDb.dll

Sestavení:: System.Data.dll

Balíček:: System.Data.OleDb v8.0.1

Balíček:: System.Data.OleDb v9.0.0-rc.2.24473.5

Zdroj:: OleDbDataReader.cs

Zdroj:: OleDbDataReader.cs

Zdroj:: OleDbDataReader.cs

Zdroj:: OleDbDataReader.cs

Zdroj:: OleDbDataReader.cs

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Poskytuje způsob čtení datového proudu pouze dopředného proudu řádků dat ze zdroje dat. Tuto třídu nelze zdě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: Object

MarshalByRefObject

DbDataReader
OleDbDataReader

Dědičnost: Object

MarshalByRefObject
OleDbDataReader

Implementuje: IEnumerable IDataReader IDataRecord IDisposable

Příklady

Následující příklad vytvoří OleDbConnection, OleDbCommanda OleDbDataReader. Příklad čte data a zapíše 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 OleDbCommand objektu namísto přímého použití konstruktoru.

Před zavření OleDbConnectionnejprve zavřete objekt OleDbDataReader. Chcete-li znovu použít objekt OleDbCommand, musíte objekt OleDbDataReader zavřít. Například nelze načíst výstupní parametry, dokud nebudete volat Close.

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

IsClosed a RecordsAffected jsou jedinými vlastnostmi, které můžete volat po zavření OleDbDataReader. I když je vlastnost RecordsAffected přístupná v době, kdy OleDbDataReader existuje, vždy zavolejte Close před vrácením hodnoty RecordsAffected, aby se zaručila 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á určuje, zda OleDbDataReader obsahuje jeden nebo více řádků.
IsClosed	Urč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řadí sloupců.
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é, vložené nebo odstraněné spuštěním příkazu SQL.
VisibleFieldCount	Získá počet polí v OleDbDataReader, které nejsou skryté.

Metody

Close()	Zavře objekt OleDbDataReader.
CloseAsync()	Asynchronně zavře objekt DbDataReader. (Zděděno od DbDataReader)
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy serveru sloužícího ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
Dispose()	Uvolní všechny prostředky používané aktuální instancí třídy DbDataReader. (Zděděno od DbDataReader)
Dispose(Boolean)	Uvolní nespravované prostředky používané DbDataReader a volitelně uvolní spravované prostředky. (Zděděno od DbDataReader)
DisposeAsync()	Asynchronně uvolní všechny prostředky používané aktuální instancí třídy DbDataReader. (Zděděno od DbDataReader)
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
Finalize()	Umožňuje objektu, aby se pokusil uvolnit prostředky a provést další operace čištění před uvolněním paměti.
GetBoolean(Int32)	Získá hodnotu zadaného sloupce jako logickou hodnotu.
GetByte(Int32)	Získá hodnotu zadaného sloupce jako bajt.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Načte datový proud bajtů ze zadaného posunu sloupce do vyrovnávací paměti jako pole začínající na daném posunu vyrovnávací paměti.
GetChar(Int32)	Získá hodnotu zadaného sloupce jako znak.
GetChars(Int32, Int64, Char[], Int32, Int32)	Načte datový proud znaků ze zadaného posunu sloupce do vyrovnávací paměti jako pole začínající na daném posunu vyrovnávací paměti.
GetColumnSchemaAsync(CancellationToken)	Toto je asynchronní verze GetColumnSchema(DbDataReader). Poskytovatelé by měli přepsat příslušnou implementací. Volitelně je možné respektovat `cancellationToken`. Výchozí implementace vyvolá synchronní volání GetColumnSchema(DbDataReader) a vrátí dokončený úkol. Výchozí implementace vrátí zrušený úkol, pokud již byla zrušena `cancellationToken`. Výjimky vyvolané GetColumnSchema(DbDataReader) budou předány prostřednictvím vrácené vlastnosti Exception úlohy. (Zděděno od DbDataReader)
GetData(Int32)	Vrátí objekt OleDbDataReader pro požadovaný řadový sloupec.
GetDataTypeName(Int32)	Získá název zdrojového datového typu.
GetDateTime(Int32)	Získá hodnotu zadaného sloupce jako DateTime objektu.
GetDbDataReader(Int32)	Vrátí objekt DbDataReader pro požadovaný řadový sloupec, který lze přepsat implementací specifickou pro zprostředkovatele. (Zděděno od DbDataReader)
GetDecimal(Int32)	Získá hodnotu zadaného sloupce jako Decimal objektu.
GetDouble(Int32)	Získá hodnotu zadaného sloupce jako číslo s plovoucí desetinnou čárkou s dvojitou přesností.
GetEnumerator()	Vrátí IEnumerator, který lze použít k iteraci řádků v čtečce dat.
GetFieldType(Int32)	Získá Type, 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, CancellationToken)	Asynchronně 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)
GetFloat(Int32)	Získá hodnotu zadaného sloupce jako číslo s plovoucí desetinnou čárkou s jednoduchou přesností.
GetGuid(Int32)	Získá hodnotu zadaného sloupce jako globálně jedinečný identifikátor (GUID).
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetInt16(Int32)	Získá hodnotu zadaného sloupce jako 16bitové celé číslo se signed.
GetInt32(Int32)	Získá hodnotu zadaného sloupce jako 32bitové signed integer.
GetInt64(Int32)	Získá hodnotu zadaného sloupce jako 64bitové celé číslo se signedem.
GetLifetimeService()	Zastaralé. Načte objekt služby aktuální životnosti, 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á řadový sloupec s názvem 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 zprostředkovatele v kolekci pro aktuální řádek. (Zděděno od DbDataReader)
GetSchemaTable()	Vrátí DataTable, která popisuje metadata sloupců OleDbDataReader.
GetSchemaTableAsync(CancellationToken)	Toto je asynchronní verze GetSchemaTable(). Poskytovatelé by měli přepsat příslušnou implementací. Volitelně je možné respektovat `cancellationToken`. Výchozí implementace vyvolá synchronní volání GetSchemaTable() a vrátí dokončený úkol. Výchozí implementace vrátí zrušený úkol, pokud již byla zrušena `cancellationToken`. Výjimky vyvolané GetSchemaTable() budou předány prostřednictvím vrácené vlastnosti Exception úlohy. (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 objektu.
GetType()	Získá Type aktuální instance. (Zděděno od Object)
GetValue(Int32)	Získá hodnotu sloupce v zadaném pořadovém formátu v nativním formátu.
GetValues(Object[])	Naplní pole objektů hodnotami sloupců aktuálního řádku.
InitializeLifetimeService()	Zastaralé. Získá objekt služby životnosti pro řízení zásad ž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, CancellationToken)	Asynchronně získá hodnotu, která označuje, zda sloupec obsahuje neexistující nebo chybějící hodnoty. (Zděděno od DbDataReader)
IsDBNullAsync(Int32)	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 Object. (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního objektu MarshalByRefObject. (Zděděno od MarshalByRefObject)
NextResult()	Při čtení výsledků dávkových příkazů SQL přejde čtečka dat na další výsledek.
NextResultAsync()	Asynchronně přejde čtenáře na další výsledek při čtení výsledků dávky příkazů. (Zděděno od DbDataReader)
NextResultAsync(CancellationToken)	Asynchronně přejde čtenáře na další výsledek při čtení výsledků dávky příkazů. (Zděděno od DbDataReader)
Read()	Přejde OleDbDataReader na další záznam.
ReadAsync()	Asynchronně přejde čtenáře na další záznam v sadě výsledků. (Zděděno od DbDataReader)
ReadAsync(CancellationToken)	Asynchronně přejde čtenáře na další záznam v sadě výsledků. (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í IDataReader pro zadaný řadový sloupec.
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()	Vrátí enumerátor, který iteruje kolekcí.

Metody rozšíření

CanGetColumnSchema(DbDataReader)	Získá hodnotu, která označuje, zda DbDataReader může získat schéma sloupce.
GetColumnSchema(DbDataReader)	Získá schéma sloupce (DbColumn kolekce) pro DbDataReader.
GetBoolean(DbDataReader, String)	Získá hodnotu zadaného sloupce jako logickou hodnotu.
GetByte(DbDataReader, String)	Získá hodnotu zadaného sloupce jako bajt.
GetBytes(DbDataReader, String, Int64, Byte[], Int32, Int32)	Načte zadaný počet bajtů ze zadaného sloupce počínaje zadaným indexem a zapíše je do vyrovnávací paměti počínaje zadanou pozicí v vyrovnávací paměti.
GetChar(DbDataReader, String)	Získá hodnotu zadaného sloupce jako jeden znak.
GetChars(DbDataReader, String, Int64, Char[], Int32, Int32)	Přečte zadaný počet znaků ze zadaného sloupce počínaje zadaným indexem a zapíše je do vyrovnávací paměti počínaje zadanou pozicí.
GetData(DbDataReader, String)	Vrátí vnořenou čtečku dat pro požadovaný sloupec.
GetDataTypeName(DbDataReader, String)	Získá název datového typu zadaného sloupce.
GetDateTime(DbDataReader, String)	Získá hodnotu zadaného sloupce jako DateTime objektu.
GetDecimal(DbDataReader, String)	Získá hodnotu zadaného sloupce jako Decimal.
GetDouble(DbDataReader, String)	Získá hodnotu zadaného sloupce jako číslo s plovoucí desetinnou čárkou s dvojitou přesností.
GetFieldType(DbDataReader, String)	Získá datový typ zadaného sloupce.
GetFieldValue<T>(DbDataReader, String)	Získá hodnotu zadaného sloupce jako požadovaný typ.
GetFieldValueAsync<T>(DbDataReader, String, CancellationToken)	Asynchronně získá hodnotu zadaného sloupce jako požadovaný typ.
GetFloat(DbDataReader, String)	Získá hodnotu zadaného sloupce jako číslo s plovoucí desetinnou čárkou s jednoduchou přesností.
GetGuid(DbDataReader, String)	Získá hodnotu zadaného sloupce jako globálně jedinečný identifikátor (GUID).
GetInt16(DbDataReader, String)	Získá hodnotu zadaného sloupce jako 16bitové celé číslo se signed.
GetInt32(DbDataReader, String)	Získá hodnotu zadaného sloupce jako 32bitové signed integer.
GetInt64(DbDataReader, String)	Získá hodnotu zadaného sloupce jako 64bitové celé číslo se signedem.
GetProviderSpecificFieldType(DbDataReader, String)	Získá typ konkrétního zprostředkovatele zadaného sloupce.
GetProviderSpecificValue(DbDataReader, String)	Získá hodnotu zadaného sloupce jako instanci typu specifického pro zprostředkovatele.
GetStream(DbDataReader, String)	Získá datový proud pro načtení dat ze zadaného sloupce.
GetString(DbDataReader, String)	Získá hodnotu zadaného sloupce jako instanci String.
GetTextReader(DbDataReader, String)	Získá čtečku textu pro načtení dat ze sloupce.
GetValue(DbDataReader, String)	Získá hodnotu zadaného sloupce jako instanci Object.
IsDBNull(DbDataReader, String)	Získá hodnotu, která označuje, zda sloupec obsahuje neexistující nebo chybějící hodnoty.
IsDBNullAsync(DbDataReader, String, CancellationToken)	Asynchronně získá hodnotu, která označuje, zda sloupec obsahuje neexistující nebo chybějící hodnoty.
Cast<TResult>(IEnumerable)	Přetypuje prvky IEnumerable na zadaný typ.
OfType<TResult>(IEnumerable)	Filtruje prvky IEnumerable na základě zadaného typu.
AsParallel(IEnumerable)	Umožňuje paralelizaci dotazu.
AsQueryable(IEnumerable)	Převede IEnumerable na IQueryable.
ConfigureAwait(IAsyncDisposable, Boolean)	Konfiguruje, jak čekají na úlohy vrácené z asynchronního jednorázového použití.

Platí pro

Viz také

datových sad a datových sad

Sdílet prostřednictvím