DataTableReader Osztály

Definíció

Névtér:

System.Data

Szerelvények:

netstandard.dll, System.Data.Common.dll

Forrás:

DataTableReader.cs

A DataTableReader rendszer egy vagy több objektum tartalmát egy vagy több DataTable írásvédett, előre csak olvasható eredményhalmaz formájában szerzi be.

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

Öröklődés

Object

MarshalByRefObject

DbDataReader

DataTableReader

Megjegyzések

Ez DataTableReader ugyanúgy működik, mint bármely más adatolvasó, például a , azzal a SqlDataReaderkivételrel, hogy a DataTableReader sorokat DataTableegy . Más szóval a gyorsítótár sorainak iterálását teszi lehetővé. A gyorsítótárazott adatok módosíthatók aktív állapotban DataTableReader , és az olvasó automatikusan fenntartja a pozícióját.

Amikor létrehoz egy DataTableReaderDataTableobjektumot, az eredményként kapott DataTableReader objektum egy olyan eredményhalmazt tartalmaz, amely ugyanazokkal az DataTable adatokkal rendelkezik, mint amelyekből létrejött, kivéve a töröltként megjelölt sorokat. Az oszlopok ugyanabban a sorrendben jelennek meg, mint az eredetiben DataTable. A visszaadott eredmény struktúrája megegyezik a sémában és az adatokban az eredetiével DataTable. Az DataTableReader objektum metódusának CreateDataReader meghívásával DataSet létrehozott objektum több eredményhalmazt is tartalmaz, ha az DataSet egynél több táblát tartalmaz. Az eredmények ugyanabban a sorrendben vannak, mint az DataTableDataTableCollection objektum objektumaiDataSet.

A visszaadott eredményhalmaz csak a törlésre megjelölt sorok aktuális verzióját DataRowtartalmazza.

A DataTableReader rendszer stabil iterátort biztosít, vagyis a rendszer nem érvényteleníti a DataTableReader gyűjtemény tartalmát, ha az alapul szolgáló gyűjtemény mérete az iteráció során módosul. Ha például a gyűjtemény egy vagy több sorát törli vagy eltávolítja az Rows iteráció során, a rendszer megfelelően tartja karban az aktuális pozíciót a DataTableReader gyűjteményen belül, és nem érvényteleníti az iterátort.

Konstruktorok

Name	Description
DataTableReader(DataTable)	Inicializálja az osztály új példányát DataTableReadera DataTable megadott adatok használatával.
DataTableReader(DataTable[])	Inicializálja az DataTableReader osztály új példányát a megadott objektumtömb DataTable használatával.

Tulajdonságok

Name	Description
Depth	Az aktuális sor beágyazásának mélysége.DataTableReader
FieldCount	Az aktuális sor oszlopainak számát adja vissza.
HasRows	Olyan értéket kap, amely jelzi, hogy a DataTableReader sor egy vagy több sort tartalmaz-e.
IsClosed	Beolvas egy értéket, amely jelzi, hogy az DataTableReader érték 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 beszúrt, módosított vagy törölt sorok számát.
VisibleFieldCount	A nem rejtett mezők DbDataReader számát adja meg. (Öröklődés forrása DbDataReader)

Metódusok

Name	Description
Close()	Bezárja az aktuálisat DataTableReader.
CloseAsync()	Aszinkron módon bezárja az DbDataReader objektumot. (Öröklődés forrása DbDataReader)
Dispose()	Az osztály aktuális példánya által használt összes erőforrást felszabadítja DbDataReader . (Öröklődés forrása DbDataReader)
Dispose(Boolean)	Felszabadítja a felügyelt erőforrások által DbDataReader használt nem felügyelt erőforrásokat, és opcionálisan felszabadítja a felügyelt erőforrásokat. (Öröklődés forrása DbDataReader)
DisposeAsync()	Aszinkron módon felszabadítja az osztály aktuális példánya által használt összes erőforrást DbDataReader . (Öröklődés forrása DbDataReader)
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetBoolean(Int32)	Lekéri a megadott oszlop Booleanértékét .
GetByte(Int32)	A megadott oszlop értékét bájtként adja meg.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	A megadott oszlopeltolástól kezdődő bájtfolyamot beolvassa a pufferbe tömbként a megadott puffereltolástól kezdve.
GetChar(Int32)	A megadott oszlop értékét adja meg karakterként.
GetChars(Int32, Int64, Char[], Int32, Int32)	A megadott oszlop értékét adja vissza karaktertömbként.
GetColumnSchemaAsync(CancellationToken)	Ez aszinkron verziója.GetColumnSchema(DbDataReader) A szolgáltatóknak felül kell bírálni a megfelelő megvalósítást. Az cancellationToken opcionálisan meg is tartható. Az alapértelmezett implementáció meghívja a szinkron GetColumnSchema(DbDataReader) hívást, és egy befejezett feladatot ad vissza. Az alapértelmezett implementáció megszakított feladatot ad vissza, ha egy már lemondott cancellationTokenfeladatot adott át. A rendszer GetColumnSchema(DbDataReader) a visszaadott Tevékenységkivétel tulajdonságon keresztül közli a kivételeket. (Öröklődés forrása DbDataReader)
GetData(Int32)	Beágyazott adatolvasót ad vissza a kért oszlophoz. (Öröklődés forrása DbDataReader)
GetDataTypeName(Int32)	Lekéri a megadott oszlop adattípusát képviselő sztringet.
GetDateTime(Int32)	A megadott oszlop értékét adja meg objektumként DateTime .
GetDbDataReader(Int32)	Olyan objektumot DbDataReader ad vissza a kért oszloprendhez, amelyet felül lehet bírálni egy szolgáltatóspecifikus implementációval. (Öröklődés forrása DbDataReader)
GetDecimal(Int32)	Lekéri a megadott oszlop Decimalértékét .
GetDouble(Int32)	Az oszlop értékét dupla pontosságú lebegőpontos számként adja meg.
GetEnumerator()	Egy enumerátort ad vissza, amely az elemgyűjteményen keresztüli iterálásra használható.
GetFieldType(Int32)	Lekéri az Type objektum adattípusát.
GetFieldValue<T>(Int32)	A megadott oszlop értékét kéri le a kért típusként. (Öröklődés forrása DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)	Aszinkron módon a megadott oszlop értékét kéri le a kért típusként. (Öröklődés forrása DbDataReader)
GetFieldValueAsync<T>(Int32)	Aszinkron módon a megadott oszlop értékét kéri le a kért típusként. (Öröklődés forrása DbDataReader)
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.
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
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.
GetLifetimeService()	Elavult. Lekéri a példány élettartamszabályzatát vezérlő aktuális élettartam-szolgáltatásobjektumot. (Öröklődés forrása MarshalByRefObject)
GetName(Int32)	Lekéri a megadott oszlop Stringértékét .
GetOrdinal(String)	Lekéri az oszlop sorszámát az oszlop nevének megadva.
GetProviderSpecificFieldType(Int32)	Lekéri a megadott oszlop típusát szolgáltatóspecifikus formátumban.
GetProviderSpecificValue(Int32)	A megadott oszlop értékét szolgáltatóspecifikus formátumban kapja meg.
GetProviderSpecificValues(Object[])	A megadott tömb kitöltése szolgáltatóspecifikus típusinformációkkal a DataTableReader.
GetSchemaTable()	DataTable Az oszlop metaadatait DataTableReaderleíró értéket ad vissza.
GetSchemaTableAsync(CancellationToken)	Ez aszinkron verziója.GetSchemaTable() A szolgáltatóknak felül kell bírálni a megfelelő megvalósítást. Az cancellationToken opcionálisan meg is tartható. Az alapértelmezett implementáció meghívja a szinkron GetSchemaTable() hívást, és egy befejezett feladatot ad vissza. Az alapértelmezett implementáció megszakított feladatot ad vissza, ha egy már lemondott cancellationTokenfeladatot adott át. A rendszer GetSchemaTable() a visszaadott Tevékenységkivétel tulajdonságon keresztül közli a kivételeket. (Öröklődés forrása DbDataReader)
GetStream(Int32)	Lekéri a streamet, amely adatokat kér le a megadott oszlopból. (Öröklődés forrása DbDataReader)
GetString(Int32)	A megadott oszlop értékét sztringként adja meg.
GetTextReader(Int32)	Lekéri a szövegolvasót az oszlop adatainak lekéréséhez. (Öröklődés forrása DbDataReader)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
GetValue(Int32)	A megadott oszlop értékét a natív formátumában kapja meg.
GetValues(Object[])	Egy objektumtömböt tölt fel az aktuális sor oszlopértékeivel.
InitializeLifetimeService()	Elavult. Beolvas egy élettartam-szolgáltatásobjektumot a példány élettartam-szabályzatának szabályozásához. (Öröklődés forrása MarshalByRefObject)
IsDBNull(Int32)	Olyan értéket kap, amely jelzi, hogy az oszlop nem létező vagy hiányzó értékeket tartalmaz-e.
IsDBNullAsync(Int32, CancellationToken)	Aszinkron módon olyan értéket kap, amely jelzi, hogy az oszlop nem létező vagy hiányzó értékeket tartalmaz-e. (Öröklődés forrása DbDataReader)
IsDBNullAsync(Int32)	Aszinkron módon olyan értéket kap, amely jelzi, hogy az oszlop nem létező vagy hiányzó értékeket tartalmaz-e. (Öröklődés forrása DbDataReader)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
MemberwiseClone(Boolean)	Az aktuális MarshalByRefObject objektum sekély másolatát hozza létre. (Öröklődés forrása MarshalByRefObject)
NextResult()	Ha van ilyen, a DataTableReader következő eredményhalmazra lép.
NextResultAsync()	Az aszinkron módon a következő eredményre viszi az olvasót egy utasításköteg eredményeinek olvasásakor. (Öröklődés forrása DbDataReader)
NextResultAsync(CancellationToken)	Az aszinkron módon a következő eredményre viszi az olvasót egy utasításköteg eredményeinek olvasásakor. (Öröklődés forrása DbDataReader)
Read()	DataTableReader A következő rekordra lép.
ReadAsync()	Aszinkron módon egy eredményhalmaz következő rekordja felé viszi az olvasót. (Öröklődés forrása DbDataReader)
ReadAsync(CancellationToken)	Aszinkron módon egy eredményhalmaz következő rekordja felé viszi az olvasót. (Öröklődés forrása DbDataReader)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

Explicit interfész-implementációk

Name	Description
IDataRecord.GetData(Int32)	Ennek a tagnak a leírását lásd GetData(Int32): . (Öröklődés forrása DbDataReader)

Bővítő metódusok

Name	Description
AsParallel(IEnumerable)	Lehetővé teszi a lekérdezés párhuzamosítását.
AsQueryable(IEnumerable)	Átalakítja az egyiket IEnumerableIQueryable.
CanGetColumnSchema(DbDataReader)	Olyan értéket kap, amely jelzi, hogy egy DbDataReader oszlopséma lekérhető-e.
Cast<TResult>(IEnumerable)	Egy elem elemeit IEnumerable a megadott típusra veti.
ConfigureAwait(IAsyncDisposable, Boolean)	Konfigurálja, hogy az aszinkron eldobható feladatok hogyan lesznek végrehajtva.
GetBoolean(DbDataReader, String)	A megadott oszlop értékét logikai értékként kapja meg.
GetByte(DbDataReader, String)	A megadott oszlop értékét bájtként adja meg.
GetBytes(DbDataReader, String, Int64, Byte[], Int32, Int32)	Beolvassa a megadott számú bájtot a megadott oszlopból egy adott indextől kezdve, és egy pufferbe írja őket, amely a puffer egy megadott helyén kezdődik.
GetChar(DbDataReader, String)	A megadott oszlop értékét egyetlen karakterként kapja meg.
GetChars(DbDataReader, String, Int64, Char[], Int32, Int32)	Beolvassa a megadott számú karaktert egy adott oszlopból egy adott indextől kezdve, és egy adott pozíciótól kezdődő pufferbe írja őket.
GetColumnSchema(DbDataReader)	Lekéri az oszlopséma (DbColumn gyűjtemény) egy DbDataReader.
GetData(DbDataReader, String)	Beágyazott adatolvasót ad vissza a kért oszlophoz.
GetDataTypeName(DbDataReader, String)	Lekéri a megadott oszlop adattípusának nevét.
GetDateTime(DbDataReader, String)	A megadott oszlop értékét adja meg objektumként DateTime .
GetDecimal(DbDataReader, String)	Lekéri a megadott oszlop Decimalértékét .
GetDouble(DbDataReader, String)	A megadott oszlop értékét dupla pontosságú lebegőpontos számként adja meg.
GetFieldType(DbDataReader, String)	Lekéri a megadott oszlop adattípusát.
GetFieldValue<T>(DbDataReader, String)	A megadott oszlop értékét kéri le a kért típusként.
GetFieldValueAsync<T>(DbDataReader, String, CancellationToken)	Aszinkron módon a megadott oszlop értékét kéri le a kért típusként.
GetFloat(DbDataReader, String)	A megadott oszlop értékét egy pontosságú lebegőpontos számként adja meg.
GetGuid(DbDataReader, String)	A megadott oszlop értékét globálisan egyedi azonosítóként (GUID) kapja meg.
GetInt16(DbDataReader, String)	A megadott oszlop értékét 16 bites aláírt egész számként kapja meg.
GetInt32(DbDataReader, String)	A megadott oszlop értékét 32 bites aláírt egész számként kapja meg.
GetInt64(DbDataReader, String)	A megadott oszlop értékét 64 bites aláírt egész számként kapja meg.
GetProviderSpecificFieldType(DbDataReader, String)	Lekéri a megadott oszlop szolgáltatóspecifikus típusát.
GetProviderSpecificValue(DbDataReader, String)	A megadott oszlop értékét egy szolgáltatóspecifikus típus példányaként kapja meg.
GetStream(DbDataReader, String)	Lekéri a streamet, amely adatokat kér le a megadott oszlopból.
GetString(DbDataReader, String)	A megadott oszlop értékét adja meg példányként String.
GetTextReader(DbDataReader, String)	Lekéri a szövegolvasót az oszlop adatainak lekéréséhez.
GetValue(DbDataReader, String)	A megadott oszlop értékét adja meg példányként Object.
IsDBNull(DbDataReader, String)	Olyan értéket kap, amely jelzi, hogy az oszlop nem létező vagy hiányzó értékeket tartalmaz-e.
IsDBNullAsync(DbDataReader, String, CancellationToken)	Aszinkron módon olyan értéket kap, amely jelzi, hogy az oszlop nem létező vagy hiányzó értékeket tartalmaz-e.
OfType<TResult>(IEnumerable)	Egy adott típus alapján szűri IEnumerable egy adott elem elemeit.