DataTableReader Klass

Definition

Namnområde:

System.Data

Sammansättning:

System.Data.dll

DataTableReader Hämtar innehållet i ett eller flera DataTable objekt i form av en eller flera skrivskyddade, endast framåtriktade resultatuppsättningar.

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

Arv

Object

MarshalByRefObject

DbDataReader

DataTableReader

Kommentarer

Fungerar DataTableReader ungefär som andra dataläsare, till exempel SqlDataReader, förutom att DataTableReader tillhandahåller för iterering över rader i en DataTable. Det innebär med andra ord att iterera över rader i en cache. Cachelagrade data kan ändras medan de DataTableReader är aktiva och läsaren behåller automatiskt sin position.

När du skapar en DataTableReader från en DataTableinnehåller det resulterande DataTableReader objektet en resultatuppsättning med samma data som den DataTable skapades från, förutom alla rader som har markerats som borttagna. Kolumnerna visas i samma ordning som i den ursprungliga DataTable. Strukturen för det returnerade resultatet är identisk i schemat och data till den ursprungliga DataTable. En DataTableReader som skapades genom att anropa metoden för CreateDataReader ett DataSet objekt innehåller flera resultatuppsättningar om innehåller DataSet mer än en tabell. Resultatet är i samma sekvens som objekten DataTableDataTableCollectionDataSet i objektet.

Den returnerade resultatuppsättningen innehåller endast den aktuella versionen av varje DataRow; rader som har markerats för borttagning hoppas över.

DataTableReader Tillhandahåller en stabil iterator, dvs. innehållet i DataTableReader den ogiltigförklaras inte om storleken på den underliggande samlingen ändras under iterationen. Om till exempel en eller flera rader i Rows samlingen tas bort eller tas bort under iterationen, underhålls den aktuella positionen inom DataTableReader den på rätt sätt och den ogiltigförklarar inte iteratorn.

Konstruktorer

Name	Description
DataTableReader(DataTable)	Initierar en ny instans av DataTableReader klassen med hjälp av data från den angivna DataTable.
DataTableReader(DataTable[])	Initierar en ny instans av klassen med hjälp av DataTableReader den angivna matrisen med DataTable objekt.

Egenskaper

Name	Description
Depth	Djupet på kapslingen för den aktuella raden i DataTableReader.
FieldCount	Returnerar antalet kolumner i den aktuella raden.
HasRows	Hämtar ett värde som anger om innehåller DataTableReader en eller flera rader.
IsClosed	Hämtar ett värde som anger om DataTableReader är stängt.
Item[Int32]	Hämtar värdet för den angivna kolumnen i sitt interna format med tanke på kolumnens ordningstal.
Item[String]	Hämtar värdet för den angivna kolumnen i sitt ursprungliga format givet kolumnnamnet.
RecordsAffected	Hämtar antalet rader som infogats, ändrats eller tagits bort genom körning av SQL-instruktionen.
VisibleFieldCount	Hämtar antalet fält i DbDataReader som inte är dolda. (Ärvd från DbDataReader)

Metoder

Name	Description
Close()	Stänger den aktuella DataTableReader.
CreateObjRef(Type)	Skapar ett objekt som innehåller all relevant information som krävs för att generera en proxy som används för att kommunicera med ett fjärrobjekt. (Ärvd från MarshalByRefObject)
Dispose()	Släpper alla resurser som används av den aktuella instansen DbDataReader av klassen. (Ärvd från DbDataReader)
Dispose(Boolean)	Släpper de ohanterade resurser som används av DbDataReader och släpper eventuellt de hanterade resurserna. (Ärvd från DbDataReader)
Equals(Object)	Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object)
GetBoolean(Int32)	Hämtar värdet för den angivna kolumnen som en Boolean.
GetByte(Int32)	Hämtar värdet för den angivna kolumnen som byte.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Läser en ström med byte som börjar vid den angivna kolumnförskjutningen till bufferten som en matris som börjar vid den angivna buffertförskjutningen.
GetChar(Int32)	Hämtar värdet för den angivna kolumnen som ett tecken.
GetChars(Int32, Int64, Char[], Int32, Int32)	Returnerar värdet för den angivna kolumnen som en teckenmatris.
GetData(Int32)	Returnerar en kapslad dataläsare för den begärda kolumnen. (Ärvd från DbDataReader)
GetDataTypeName(Int32)	Hämtar en sträng som representerar datatypen för den angivna kolumnen.
GetDateTime(Int32)	Hämtar värdet för den angivna kolumnen som ett DateTime objekt.
GetDbDataReader(Int32)	Returnerar ett DbDataReader objekt för den begärda kolumnordningen som kan åsidosättas med en providerspecifik implementering. (Ärvd från DbDataReader)
GetDecimal(Int32)	Hämtar värdet för den angivna kolumnen som en Decimal.
GetDouble(Int32)	Hämtar värdet för kolumnen som ett flyttal med dubbel precision.
GetEnumerator()	Returnerar en uppräknare som kan användas för att iterera genom objektsamlingen.
GetFieldType(Int32)	Type Hämtar objektets datatyp.
GetFieldValue<T>(Int32)	Hämtar värdet för den angivna kolumnen som den begärda typen. (Ärvd från DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)	Asynkront hämtar värdet för den angivna kolumnen som den begärda typen. (Ärvd från DbDataReader)
GetFieldValueAsync<T>(Int32)	Asynkront hämtar värdet för den angivna kolumnen som den begärda typen. (Ärvd från DbDataReader)
GetFloat(Int32)	Hämtar värdet för den angivna kolumnen som ett flyttal med enkel precision.
GetGuid(Int32)	Hämtar värdet för den angivna kolumnen som en globalt unik identifierare (GUID).
GetHashCode()	Fungerar som standard-hash-funktion. (Ärvd från Object)
GetInt16(Int32)	Hämtar värdet för den angivna kolumnen som ett 16-bitars signerat heltal.
GetInt32(Int32)	Hämtar värdet för den angivna kolumnen som ett 32-bitars signerat heltal.
GetInt64(Int32)	Hämtar värdet för den angivna kolumnen som ett 64-bitars signerat heltal.
GetLifetimeService()	Hämtar det aktuella livslängdstjänstobjektet som styr livslängdsprincipen för den här instansen. (Ärvd från MarshalByRefObject)
GetName(Int32)	Hämtar värdet för den angivna kolumnen som en String.
GetOrdinal(String)	Hämtar kolumnordningen med namnet på kolumnen.
GetProviderSpecificFieldType(Int32)	Hämtar den angivna kolumnens typ i providerspecifikt format.
GetProviderSpecificValue(Int32)	Hämtar värdet för den angivna kolumnen i providerspecifikt format.
GetProviderSpecificValues(Object[])	Fyller den angivna matrisen med providerspecifik typinformation för alla kolumner i DataTableReader.
GetSchemaTable()	Returnerar en DataTable som beskriver kolumnmetadata för DataTableReader.
GetStream(Int32)	Hämtar en dataström för att hämta data från den angivna kolumnen. (Ärvd från DbDataReader)
GetString(Int32)	Hämtar värdet för den angivna kolumnen som en sträng.
GetTextReader(Int32)	Hämtar en textläsare för att hämta data från kolumnen. (Ärvd från DbDataReader)
GetType()	Hämtar den aktuella instansen Type . (Ärvd från Object)
GetValue(Int32)	Hämtar värdet för den angivna kolumnen i sitt interna format.
GetValues(Object[])	Fyller i en matris med objekt med kolumnvärdena för den aktuella raden.
InitializeLifetimeService()	Hämtar ett tjänstobjekt för livslängd för att styra livslängdsprincipen för den här instansen. (Ärvd från MarshalByRefObject)
IsDBNull(Int32)	Hämtar ett värde som anger om kolumnen innehåller icke-existerande eller saknade värden.
IsDBNullAsync(Int32, CancellationToken)	Asynkront hämtar ett värde som anger om kolumnen innehåller obefintliga eller saknade värden. (Ärvd från DbDataReader)
IsDBNullAsync(Int32)	Asynkront hämtar ett värde som anger om kolumnen innehåller obefintliga eller saknade värden. (Ärvd från DbDataReader)
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
MemberwiseClone(Boolean)	Skapar en ytlig kopia av det aktuella MarshalByRefObject objektet. (Ärvd från MarshalByRefObject)
NextResult()	DataTableReader Går vidare till nästa resultatuppsättning, om någon.
NextResultAsync()	Asynkront avancerar läsaren till nästa resultat när du läser resultatet av en batch med instruktioner. (Ärvd från DbDataReader)
NextResultAsync(CancellationToken)	Asynkront avancerar läsaren till nästa resultat när du läser resultatet av en batch med instruktioner. (Ärvd från DbDataReader)
Read()	DataTableReader Går vidare till nästa post.
ReadAsync()	Asynkront avancerar läsaren till nästa post i en resultatuppsättning. (Ärvd från DbDataReader)
ReadAsync(CancellationToken)	Asynkront avancerar läsaren till nästa post i en resultatuppsättning. (Ärvd från DbDataReader)
ToString()	Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object)

Explicita gränssnittsimplementeringar

Name	Description
IDataRecord.GetData(Int32)	En beskrivning av den här medlemmen finns i GetData(Int32). (Ärvd från DbDataReader)

Tilläggsmetoder

Name	Description
AsParallel(IEnumerable)	Möjliggör parallellisering av en fråga.
AsQueryable(IEnumerable)	Konverterar en IEnumerable till en IQueryable.
CanGetColumnSchema(DbDataReader)	Hämtar ett värde som anger om en DbDataReader kan hämta ett kolumnschema.
Cast<TResult>(IEnumerable)	Omvandlar elementen i en IEnumerable till den angivna typen.
GetColumnSchema(DbDataReader)	Hämtar kolumnschemat (DbColumn samlingen) för en DbDataReader.
OfType<TResult>(IEnumerable)	Filtrerar elementen i en IEnumerable baserat på en angiven typ.