DataTableReader Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Met DataTableReader haalt u de inhoud van een of meer DataTable objecten op in de vorm van een of meer alleen-lezen, alleen-vooruit resultatensets.
public ref class DataTableReader sealed : System::Data::Common::DbDataReaderpublic sealed class DataTableReader : System.Data.Common.DbDataReadertype DataTableReader = class
inherit DbDataReaderPublic NotInheritable Class DataTableReader
Inherits DbDataReader- Overname
Opmerkingen
Het DataTableReader werkt net als elke andere gegevenslezer, zoals de SqlDataReader, behalve dat het voorziet in het DataTableReader herhalen van rijen in een DataTable. Met andere woorden, het biedt voor het herhalen van rijen in een cache. De gegevens in de cache kunnen worden gewijzigd terwijl de DataTableReader gegevens actief zijn en de lezer behoudt automatisch de positie ervan.
Wanneer u een DataTableReader van een DataTableobject maakt, bevat het resulterende DataTableReader object één resultatenset met dezelfde gegevens als de DataTable gegevens waaruit het is gemaakt, met uitzondering van rijen die zijn gemarkeerd als verwijderd. De kolommen worden weergegeven in dezelfde volgorde als in het origineel DataTable. De structuur van het geretourneerde resultaat is identiek in schema en gegevens aan het origineel DataTable. Een DataTableReader die is gemaakt door de CreateDataReader methode van een DataSet object aan te roepen, bevat meerdere resultatensets als de DataSet tabel meer dan één tabel bevat. De resultaten bevinden zich in dezelfde volgorde als de DataTable objecten in het DataTableCollectionDataSet object.
De geretourneerde resultatenset bevat alleen de huidige versie van elke DataRowrij; rijen die zijn gemarkeerd voor verwijdering, worden overgeslagen.
Het DataTableReader biedt een stabiele iterator; dat wil gezegd, de inhoud van de DataTableReader verzameling wordt niet ongeldig als de grootte van de onderliggende verzameling wordt gewijzigd tijdens iteratie. Als bijvoorbeeld een of meer rijen in de verzameling tijdens iteratie Rows worden verwijderd of verwijderd, wordt de huidige positie binnen de DataTableReader verzameling op de juiste wijze behouden en wordt de iterator niet ongeldig.
Constructors
| Name | Description |
|---|---|
| DataTableReader(DataTable) |
Initialiseert een nieuw exemplaar van de DataTableReader klasse met behulp van gegevens uit de opgegeven DataTable. |
| DataTableReader(DataTable[]) |
Initialiseert een nieuw exemplaar van de DataTableReader klasse met behulp van de opgegeven matrix met DataTable objecten. |
Eigenschappen
| Name | Description |
|---|---|
| Depth |
De diepte van nesten voor de huidige rij van de DataTableReader. |
| FieldCount |
Retourneert het aantal kolommen in de huidige rij. |
| HasRows |
Hiermee wordt een waarde opgehaald die aangeeft of de DataTableReader rijen een of meer rijen bevatten. |
| IsClosed |
Hiermee wordt een waarde opgehaald die aangeeft of de DataTableReader waarde is gesloten. |
| Item[Int32] |
Hiermee haalt u de waarde van de opgegeven kolom op in de systeemeigen indeling op basis van de kolomordinaal. |
| Item[String] |
Hiermee haalt u de waarde van de opgegeven kolom op in de systeemeigen indeling op basis van de kolomnaam. |
| RecordsAffected |
Hiermee wordt het aantal rijen opgehaald dat is ingevoegd, gewijzigd of verwijderd door de SQL-instructie uit te voeren. |
| VisibleFieldCount |
Hiermee haalt u het aantal velden op DbDataReader dat niet verborgen is. (Overgenomen van DbDataReader) |
Methoden
| Name | Description |
|---|---|
| Close() |
Hiermee sluit u de huidige DataTableReader. |
| CloseAsync() |
Sluit het DbDataReader object asynchroon. (Overgenomen van DbDataReader) |
| CreateObjRef(Type) |
Hiermee maakt u een object dat alle relevante informatie bevat die nodig is om een proxy te genereren die wordt gebruikt om te communiceren met een extern object. (Overgenomen van MarshalByRefObject) |
| Dispose() |
Alle resources die door het huidige exemplaar van de DbDataReader klasse worden gebruikt, worden vrijgegeven. (Overgenomen van DbDataReader) |
| Dispose(Boolean) |
Publiceert de niet-beheerde resources die worden gebruikt door de DbDataReader beheerde resources en brengt eventueel de beheerde resources vrij. (Overgenomen van DbDataReader) |
| DisposeAsync() |
Asynchroon brengt alle resources vrij die worden gebruikt door het huidige exemplaar van de DbDataReader klasse. (Overgenomen van DbDataReader) |
| Equals(Object) |
Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object) |
| GetBoolean(Int32) |
Hiermee haalt u de waarde van de opgegeven kolom op als een Boolean. |
| GetByte(Int32) |
Hiermee haalt u de waarde van de opgegeven kolom op als een byte. |
| GetBytes(Int32, Int64, Byte[], Int32, Int32) |
Hiermee wordt een stroom bytes gelezen die begint bij de opgegeven kolom offset in de buffer als een matrix die begint bij de opgegeven buffer offset. |
| GetChar(Int32) |
Hiermee haalt u de waarde van de opgegeven kolom op als een teken. |
| GetChars(Int32, Int64, Char[], Int32, Int32) |
Retourneert de waarde van de opgegeven kolom als een tekenmatrix. |
| GetData(Int32) |
Retourneert een geneste gegevenslezer voor de aangevraagde kolom. (Overgenomen van DbDataReader) |
| GetDataTypeName(Int32) |
Hiermee haalt u een tekenreeks op die het gegevenstype van de opgegeven kolom vertegenwoordigt. |
| GetDateTime(Int32) |
Hiermee haalt u de waarde van de opgegeven kolom op als een DateTime object. |
| GetDbDataReader(Int32) |
Retourneert een DbDataReader object voor de aangevraagde kolomordinaal die kan worden overschreven met een providerspecifieke implementatie. (Overgenomen van DbDataReader) |
| GetDecimal(Int32) |
Hiermee haalt u de waarde van de opgegeven kolom op als een Decimal. |
| GetDouble(Int32) |
Hiermee haalt u de waarde van de kolom op als een drijvendekommagetal met dubbele precisie. |
| GetEnumerator() |
Retourneert een enumerator die kan worden gebruikt om de itemverzameling te herhalen. |
| GetFieldType(Int32) |
Hiermee haalt u het Type gegevenstype van het object op. |
| GetFieldValue<T>(Int32) |
Hiermee haalt u de waarde van de opgegeven kolom op als het aangevraagde type. (Overgenomen van DbDataReader) |
| GetFieldValueAsync<T>(Int32, CancellationToken) |
Asynchroon haalt de waarde van de opgegeven kolom op als het aangevraagde type. (Overgenomen van DbDataReader) |
| GetFieldValueAsync<T>(Int32) |
Asynchroon haalt de waarde van de opgegeven kolom op als het aangevraagde type. (Overgenomen van DbDataReader) |
| GetFloat(Int32) |
Hiermee haalt u de waarde van de opgegeven kolom op als een drijvendekommagetal met één precisie. |
| GetGuid(Int32) |
Hiermee haalt u de waarde van de opgegeven kolom op als guid (globally-unique identifier). |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetInt16(Int32) |
Hiermee haalt u de waarde van de opgegeven kolom op als een 16-bits geheel getal dat is ondertekend. |
| GetInt32(Int32) |
Hiermee haalt u de waarde van de opgegeven kolom op als een 32-bits geheel getal dat is ondertekend. |
| GetInt64(Int32) |
Hiermee haalt u de waarde van de opgegeven kolom op als een 64-bits geheel getal dat is ondertekend. |
| GetLifetimeService() |
Hiermee haalt u het huidige levensduurserviceobject op waarmee het levensduurbeleid voor dit exemplaar wordt beheerd. (Overgenomen van MarshalByRefObject) |
| GetName(Int32) |
Hiermee haalt u de waarde van de opgegeven kolom op als een String. |
| GetOrdinal(String) |
Hiermee haalt u de kolomordinaal op, op basis van de naam van de kolom. |
| GetProviderSpecificFieldType(Int32) |
Hiermee haalt u het type van de opgegeven kolom op in providerspecifieke indeling. |
| GetProviderSpecificValue(Int32) |
Hiermee haalt u de waarde op van de opgegeven kolom in providerspecifieke indeling. |
| GetProviderSpecificValues(Object[]) |
Vult de opgegeven matrix met providerspecifieke typegegevens voor alle kolommen in de DataTableReader. |
| GetSchemaTable() |
Retourneert een DataTable die de kolommetagegevens van de DataTableReader. |
| GetStream(Int32) |
Hiermee haalt u een stroom op om gegevens op te halen uit de opgegeven kolom. (Overgenomen van DbDataReader) |
| GetString(Int32) |
Hiermee haalt u de waarde van de opgegeven kolom op als een tekenreeks. |
| GetTextReader(Int32) |
Hiermee haalt u een tekstlezer op om gegevens op te halen uit de kolom. (Overgenomen van DbDataReader) |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| GetValue(Int32) |
Hiermee haalt u de waarde van de opgegeven kolom op in de systeemeigen indeling. |
| GetValues(Object[]) |
Hiermee wordt een matrix met objecten gevuld met de kolomwaarden van de huidige rij. |
| InitializeLifetimeService() |
Hiermee haalt u een levensduurserviceobject op om het levensduurbeleid voor dit exemplaar te beheren. (Overgenomen van MarshalByRefObject) |
| IsDBNull(Int32) |
Hiermee wordt een waarde opgehaald die aangeeft of de kolom niet-bestaande of ontbrekende waarden bevat. |
| IsDBNullAsync(Int32, CancellationToken) |
Asynchroon krijgt een waarde die aangeeft of de kolom niet-bestaande of ontbrekende waarden bevat. (Overgenomen van DbDataReader) |
| IsDBNullAsync(Int32) |
Asynchroon krijgt een waarde die aangeeft of de kolom niet-bestaande of ontbrekende waarden bevat. (Overgenomen van DbDataReader) |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| MemberwiseClone(Boolean) |
Hiermee maakt u een ondiepe kopie van het huidige MarshalByRefObject object. (Overgenomen van MarshalByRefObject) |
| NextResult() |
DataTableReader Hiermee gaat u naar de volgende resultatenset, indien van toepassing. |
| NextResultAsync() |
De lezer wordt asynchroon naar het volgende resultaat doorgevroegd bij het lezen van de resultaten van een batch met instructies. (Overgenomen van DbDataReader) |
| NextResultAsync(CancellationToken) |
De lezer wordt asynchroon naar het volgende resultaat doorgevroegd bij het lezen van de resultaten van een batch met instructies. (Overgenomen van DbDataReader) |
| Read() |
Hiermee gaat u naar DataTableReader de volgende record. |
| ReadAsync() |
De lezer wordt asynchroon doorgezet naar de volgende record in een resultatenset. (Overgenomen van DbDataReader) |
| ReadAsync(CancellationToken) |
De lezer wordt asynchroon doorgezet naar de volgende record in een resultatenset. (Overgenomen van DbDataReader) |
| ToString() |
Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object) |
Expliciete interface-implementaties
| Name | Description |
|---|---|
| IDataRecord.GetData(Int32) |
Zie voor een beschrijving van dit lid GetData(Int32). (Overgenomen van DbDataReader) |
Extensiemethoden
| Name | Description |
|---|---|
| AsParallel(IEnumerable) |
Hiermee schakelt u parallelle uitvoering van een query in. |
| AsQueryable(IEnumerable) |
Converteert een IEnumerable naar een IQueryable. |
| CanGetColumnSchema(DbDataReader) |
Hiermee wordt een waarde opgehaald die aangeeft of een DbDataReader kolomschema kan worden opgehaald. |
| Cast<TResult>(IEnumerable) |
Cast de elementen van een IEnumerable naar het opgegeven type. |
| ConfigureAwait(IAsyncDisposable, Boolean) |
Hiermee configureert u hoe wacht op de taken die worden geretourneerd op basis van een asynchroon wegwerp, worden uitgevoerd. |
| GetBoolean(DbDataReader, String) |
Hiermee haalt u de waarde van de opgegeven kolom op als een Booleaanse waarde. |
| GetByte(DbDataReader, String) |
Hiermee haalt u de waarde van de opgegeven kolom op als een byte. |
| GetBytes(DbDataReader, String, Int64, Byte[], Int32, Int32) |
Leest een opgegeven aantal bytes uit de opgegeven kolom vanaf een opgegeven index en schrijft deze naar een buffer vanaf een opgegeven positie in de buffer. |
| GetChar(DbDataReader, String) |
Hiermee haalt u de waarde van de opgegeven kolom op als één teken. |
| GetChars(DbDataReader, String, Int64, Char[], Int32, Int32) |
Leest een opgegeven aantal tekens uit een opgegeven kolom vanaf een opgegeven index en schrijft deze naar een buffer vanaf een opgegeven positie. |
| GetColumnSchema(DbDataReader) |
Hiermee haalt u het kolomschema (DbColumn verzameling) voor een DbDataReader. |
| GetData(DbDataReader, String) |
Retourneert een geneste gegevenslezer voor de aangevraagde kolom. |
| GetDataTypeName(DbDataReader, String) |
Hiermee wordt de naam van het gegevenstype van de opgegeven kolom opgehaald. |
| GetDateTime(DbDataReader, String) |
Hiermee haalt u de waarde van de opgegeven kolom op als een DateTime object. |
| GetDecimal(DbDataReader, String) |
Hiermee haalt u de waarde van de opgegeven kolom op als een Decimal. |
| GetDouble(DbDataReader, String) |
Hiermee haalt u de waarde van de opgegeven kolom op als een drijvendekommagetal met dubbele precisie. |
| GetFieldType(DbDataReader, String) |
Hiermee haalt u het gegevenstype van de opgegeven kolom op. |
| GetFieldValue<T>(DbDataReader, String) |
Hiermee haalt u de waarde van de opgegeven kolom op als het aangevraagde type. |
| GetFieldValueAsync<T>(DbDataReader, String, CancellationToken) |
Asynchroon haalt de waarde van de opgegeven kolom op als het aangevraagde type. |
| GetFloat(DbDataReader, String) |
Hiermee haalt u de waarde van de opgegeven kolom op als een drijvendekommagetal met één precisie. |
| GetGuid(DbDataReader, String) |
Hiermee haalt u de waarde van de opgegeven kolom op als een GUID (Globally Unique Identifier). |
| GetInt16(DbDataReader, String) |
Hiermee haalt u de waarde van de opgegeven kolom op als een 16-bits geheel getal dat is ondertekend. |
| GetInt32(DbDataReader, String) |
Hiermee haalt u de waarde van de opgegeven kolom op als een 32-bits geheel getal dat is ondertekend. |
| GetInt64(DbDataReader, String) |
Hiermee haalt u de waarde van de opgegeven kolom op als een 64-bits geheel getal dat is ondertekend. |
| GetProviderSpecificFieldType(DbDataReader, String) |
Hiermee haalt u het providerspecifieke type van de opgegeven kolom op. |
| GetProviderSpecificValue(DbDataReader, String) |
Hiermee haalt u de waarde van de opgegeven kolom op als een exemplaar van een providerspecifiek type. |
| GetStream(DbDataReader, String) |
Hiermee haalt u een stroom op om gegevens op te halen uit de opgegeven kolom. |
| GetString(DbDataReader, String) |
Hiermee haalt u de waarde van de opgegeven kolom op als een exemplaar van String. |
| GetTextReader(DbDataReader, String) |
Hiermee haalt u een tekstlezer op om gegevens op te halen uit de kolom. |
| GetValue(DbDataReader, String) |
Hiermee haalt u de waarde van de opgegeven kolom op als een exemplaar van Object. |
| IsDBNull(DbDataReader, String) |
Hiermee wordt een waarde opgehaald die aangeeft of de kolom niet-bestaande of ontbrekende waarden bevat. |
| IsDBNullAsync(DbDataReader, String, CancellationToken) |
Asynchroon krijgt een waarde die aangeeft of de kolom niet-bestaande of ontbrekende waarden bevat. |
| OfType<TResult>(IEnumerable) |
Hiermee filtert u de elementen van een IEnumerable op basis van een opgegeven type. |