DataTableReader Třída

Definice

Obor názvů:

System.Data

Sestavení:

System.Data.Common.dll

Sestavení:

System.Data.dll

Sestavení:

netstandard.dll

Získá DataTableReader obsah jednoho nebo více DataTable objektů ve formě jedné nebo více sad výsledků jen pro čtení.

public ref class DataTableReader sealed : System::Data::Common::DbDataReader

public sealed class DataTableReader : System.Data.Common.DbDataReader

type DataTableReader = class
    inherit DbDataReader

Public NotInheritable Class DataTableReader
Inherits DbDataReader

Dědičnost

Object

MarshalByRefObject

DbDataReader

DataTableReader

Poznámky

Funguje DataTableReader podobně jako jakákoli jiná čtečka dat, jako SqlDataReaderje například , s tím rozdílem, že DataTableReader poskytuje iteraci nad řádky v .DataTable Jinými slovy, poskytuje iteraci nad řádky v mezipaměti. Data uložená v mezipaměti je možné upravit, když DataTableReader je aktivní, a čtenář si automaticky udržuje svou pozici.

Když vytvoříte z objektu DataTableReader DataTable, výsledný DataTableReader objekt obsahuje jednu sadu výsledků se stejnými daty, DataTable ze kterých byla vytvořena, s výjimkou všech řádků, které byly označeny jako odstraněné. Sloupce se zobrazí ve stejném pořadí jako v původním DataTablepořadí. Struktura vráceného výsledku je stejná ve schématu a datech jako původní DataTable. Objekt DataTableReader vytvořený voláním CreateDataReader metody objektu DataSet obsahuje více sad výsledků, pokud DataSet obsahuje více tabulek. Výsledky jsou ve stejné sekvenci jako DataTable objekty v DataTableCollection objektu DataSet .

Vrácená sada výsledků obsahuje pouze aktuální verzi jednotlivých DataRowřádků, které jsou označené k odstranění, se přeskočí.

Poskytuje stabilní iterátor. To DataTableReader znamená, že obsah DataTableReader této kolekce není neplatný, pokud se během iterace změní velikost podkladové kolekce. Pokud se například během iterace odstraní nebo odebere jeden nebo více řádků v Rows kolekci, zachová se aktuální pozice v rámci DataTableReader této kolekce odpovídajícím způsobem a iterátor nebude zneplatnit.

Konstruktory

DataTableReader(DataTable)	Inicializuje novou instanci DataTableReader třídy pomocí dat ze zadané DataTable.
DataTableReader(DataTable[])	Inicializuje novou instanci DataTableReader třídy pomocí zadané pole DataTable objektů.

Vlastnosti

Depth	Hloubka vnoření pro aktuální řádek DataTableReader.
FieldCount	Vrátí počet sloupců v aktuálním řádku.
HasRows	Získá hodnotu, která označuje, zda DataTableReader obsahuje jeden nebo více řádků.
IsClosed	Získá hodnotu, která označuje, zda je uzavřena DataTableReader .
Item[Int32]	Získá hodnotu zadaného sloupce ve svém nativním formátu vzhledem k pořadí sloupců.
Item[String]	Získá hodnotu zadaného sloupce ve svém nativním formátu vzhledem k názvu sloupce.
RecordsAffected	Získá počet řádků vložených, změněných nebo odstraněných spuštěním příkazu SQL.
VisibleFieldCount	Získá početpolích DbDataReader (Zděděno od DbDataReader)

Metody

Close()	Zavře aktuální DataTableReader.
CloseAsync()	Asynchronně objekt zavře DbDataReader . (Zděděno od DbDataReader)
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy serveru používaného 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é a DbDataReader 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)
GetBoolean(Int32)	Získá hodnotu zadaného sloupce jako Boolean.
GetByte(Int32)	Získá hodnotu zadaného sloupce jako bajt.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Načte datový proud bajtů začínající od zadaného posunu sloupce do vyrovnávací paměti jako pole začínající na zadaném posunu vyrovnávací paměti.
GetChar(Int32)	Získá hodnotu zadaného sloupce jako znak.
GetChars(Int32, Int64, Char[], Int32, Int32)	Vrátí hodnotu zadaného sloupce jako pole znaků.
GetColumnSchemaAsync(CancellationToken)	Toto je asynchronní verze GetColumnSchema(DbDataReader). Poskytovatelé by měli přepsat příslušnou implementací. Volitelně cancellationToken lze respektovat. Výchozí implementace vyvolá synchronní GetColumnSchema(DbDataReader) volání a vrátí dokončený úkol. Výchozí implementace vrátí zrušený úkol, pokud již byla zrušena cancellationToken. Výjimky vyvolány GetColumnSchema(DbDataReader) prostřednictvím vrácené vlastnosti Exception úkolu. (Zděděno od DbDataReader)
GetData(Int32)	Vrátí vnořenou čtečku dat pro požadovaný sloupec. (Zděděno od DbDataReader)
GetDataTypeName(Int32)	Získá řetězec představující datový typ zadaného sloupce.
GetDateTime(Int32)	Získá hodnotu zadaného sloupce jako DateTime objekt.
GetDbDataReader(Int32)	DbDataReader Vrátí objekt pro požadovaný sloupec ordinál, který lze přepsat pomocí implementace specifické pro zprostředkovatele. (Zděděno od DbDataReader)
GetDecimal(Int32)	Získá hodnotu zadaného sloupce jako Decimal.
GetDouble(Int32)	Získá hodnotu sloupce jako číslo s plovoucí desetinnou čárkou s dvojitou přesností.
GetEnumerator()	Vrátí enumerátor, který lze použít k iteraci v kolekci položek.
GetFieldType(Int32)	Type Získá to 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í desetinnou čá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í funkce hash. (Zděděno od Object)
GetInt16(Int32)	Získá hodnotu zadaného sloupce jako 16bitové celé číslo podepsaného.
GetInt32(Int32)	Získá hodnotu zadaného sloupce jako 32bitové celé číslo podepsaného.
GetInt64(Int32)	Získá hodnotu zadaného sloupce jako 64bitové podepsané celé číslo.
GetLifetimeService()	Zastaralé. Načte aktuální objekt služby životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetName(Int32)	Získá hodnotu zadaného sloupce jako String.
GetOrdinal(String)	Získá pořadový sloupec s názvem sloupce.
GetProviderSpecificFieldType(Int32)	Získá typ zadaného sloupce ve formátu specifickém pro zprostředkovatele.
GetProviderSpecificValue(Int32)	Získá hodnotu zadaného sloupce ve formátu specifickém pro zprostředkovatele.
GetProviderSpecificValues(Object[])	Vyplní zadané pole informacemi o typu specifické pro zprostředkovatele pro všechny sloupce v poli DataTableReader.
GetSchemaTable()	DataTable Vrátí hodnotu, která popisuje metadata DataTableReadersloupce .
GetSchemaTableAsync(CancellationToken)	Toto je asynchronní verze GetSchemaTable(). Poskytovatelé by měli přepsat příslušnou implementaci. Volitelně cancellationToken může být ctěna. Výchozí implementace vyvolá synchronní GetSchemaTable() volání a vrátí dokončenou úlohu. Výchozí implementace vrátí zrušenou úlohu, pokud již byla zrušena cancellationToken. Výjimky vyvoláné pomocí GetSchemaTable() vrácené vlastnosti Výjimky ú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)
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
GetValue(Int32)	Získá hodnotu zadaného sloupce v jeho nativním formátu.
GetValues(Object[])	Naplní pole objektů hodnotami sloupce 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)	Asynchronně získá hodnotu, která označuje, jestli sloupec obsahuje neexistující nebo chybějící hodnoty. (Zděděno od DbDataReader)
IsDBNullAsync(Int32, CancellationToken)	Asynchronně získá hodnotu, která označuje, jestli sloupec obsahuje neexistující nebo chybějící hodnoty. (Zděděno od DbDataReader)
MemberwiseClone()	Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří kopii aktuálního objektu bez MarshalByRefObject podmět. (Zděděno od MarshalByRefObject)
NextResult()	V DataTableReader případě potřeby přejde na další sadu výsledků.
NextResultAsync()	Asynchronně přejde čtenář k dalšímu výsledku při čtení výsledků dávky příkazů. (Zděděno od DbDataReader)
NextResultAsync(CancellationToken)	Asynchronně přejde čtenář k dalšímu výsledku při čtení výsledků dávky příkazů. (Zděděno od DbDataReader)
Read()	Přejde na DataTableReader 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)

Popis tohoto člena najdete v tématu GetData(Int32). (Zděděno od DbDataReader)

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)	Přeč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 objekt.
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 jednou 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é podepsané celé číslo.
GetInt64(DbDataReader, String)	Získá hodnotu zadaného sloupce jako 64bitové podepsané celé číslo.
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 instance 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 instance 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, jestli sloupec obsahuje neexistující nebo chybějící hodnoty.
Cast<TResult>(IEnumerable)	Přetypuje prvky zadaného IEnumerable typu.
OfType<TResult>(IEnumerable)	Filtruje prvky IEnumerable založené na zadaném typu.
AsParallel(IEnumerable)	Umožňuje paralelizaci dotazu.
AsQueryable(IEnumerable)	Převede na IEnumerable IQueryable.
ConfigureAwait(IAsyncDisposable, Boolean)	Nakonfiguruje, jak se čekají na úlohy vrácené z asynchronního jednorázového provedení.