DataTableReader Klasa

Definicja

Przestrzeń nazw:

System.Data

Zestaw:

System.Data.Common.dll

Zestaw:

System.Data.dll

Zestaw:

netstandard.dll

Obiekt DataTableReader uzyskuje zawartość co najmniej jednego obiektu w postaci jednego lub większej DataTable liczby zestawów wyników tylko do odczytu, tylko do przodu.

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

Dziedziczenie

Object

MarshalByRefObject

DbDataReader

DataTableReader

Uwagi

Działa DataTableReader podobnie jak każdy inny czytnik danych, taki jak SqlDataReader, z tą różnicą, że DataTableReader zapewnia iterację wierszy w obiekcie DataTable. Innymi słowy, zapewnia iterację wierszy w pamięci podręcznej. Buforowane dane można modyfikować, gdy element DataTableReader jest aktywny, a czytnik automatycznie zachowuje swoją pozycję.

Podczas tworzenia obiektu na DataTableReader podstawie DataTableobiektu wynikowego DataTableReader zawiera jeden zestaw wyników z tymi samymi danymi, DataTable z których został utworzony, z wyjątkiem wszystkich wierszy oznaczonych jako usunięte. Kolumny są wyświetlane w tej samej kolejności co w oryginalnej DataTablekolejności . Struktura zwróconego wyniku jest identyczna w schemacie i danych z oryginalnym DataTableelementem . Element DataTableReader utworzony przez wywołanie CreateDataReader metody DataSet obiektu zawiera wiele zestawów wyników, jeśli zawiera DataSet więcej niż jedną tabelę. Wyniki są w tej samej sekwencji co DataTable obiekty w DataTableCollection DataSet obiekcie.

Zwrócony zestaw wyników zawiera tylko bieżącą wersję każdego DataRow; wiersze oznaczone do usunięcia są pomijane.

Zapewnia DataTableReader stabilny iterator, czyli zawartość elementu DataTableReader nie jest unieważniona, jeśli rozmiar bazowej kolekcji jest modyfikowany podczas iteracji. Jeśli na przykład co najmniej jeden wiersz w kolekcji zostanie usunięty lub usunięty podczas iteracji, bieżąca pozycja w Rows DataTableReader obiekcie jest odpowiednio utrzymywana i nie unieważnia iteratora.

Konstruktory

DataTableReader(DataTable)	Inicjuje DataTableReader nowe wystąpienie klasy przy użyciu danych z dostarczonego DataTableelementu .
DataTableReader(DataTable[])	Inicjuje DataTableReader nowe wystąpienie klasy przy użyciu dostarczonej tablicy DataTable obiektów.

Właściwości

Depth	Głębokość zagnieżdżania dla bieżącego wiersza elementu DataTableReader.
FieldCount	Zwraca liczbę kolumn w bieżącym wierszu.
HasRows	Pobiera wartość wskazującą, czy zawiera DataTableReader jeden lub więcej wierszy.
IsClosed	Pobiera wartość wskazującą, czy DataTableReader element jest zamknięty.
Item[Int32]	Pobiera wartość określonej kolumny w formacie natywnym, biorąc pod uwagę liczbę porządkową kolumny.
Item[String]	Pobiera wartość określonej kolumny w formacie natywnym, biorąc pod uwagę nazwę kolumny.
RecordsAffected	Pobiera liczbę wstawionych, zmienionych lub usuniętych wierszy przez wykonanie instrukcji SQL.
VisibleFieldCount	Pobiera liczbę pól w polach DbDataReader , które nie są ukryte. (Odziedziczone po DbDataReader)

Metody

Close()	Zamyka bieżący element DataTableReader.
CloseAsync()	Asynchronicznie zamyka DbDataReader obiekt. (Odziedziczone po DbDataReader)
CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Dispose()	Zwalnia wszystkie zasoby używane przez bieżące wystąpienie klasy DbDataReader. (Odziedziczone po DbDataReader)
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element DbDataReader i opcjonalnie zwalnia zasoby zarządzane. (Odziedziczone po DbDataReader)
DisposeAsync()	Asynchronicznie zwalnia wszystkie zasoby używane przez bieżące wystąpienie DbDataReader klasy. (Odziedziczone po DbDataReader)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetBoolean(Int32)	Pobiera wartość określonej kolumny jako Boolean.
GetByte(Int32)	Pobiera wartość określonej kolumny jako bajt.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Odczytuje strumień bajtów rozpoczynający się od przesunięcia określonej kolumny do buforu jako tablicy rozpoczynającej się od określonego przesunięcia buforu.
GetChar(Int32)	Pobiera wartość określonej kolumny jako znak.
GetChars(Int32, Int64, Char[], Int32, Int32)	Zwraca wartość określonej kolumny jako tablicę znaków.
GetColumnSchemaAsync(CancellationToken)	Jest to asynchroniczna wersja programu GetColumnSchema(DbDataReader). Dostawcy powinni zastąpić odpowiednią implementacją. Opcjonalnie cancellationToken można je honorować. Domyślna implementacja wywołuje wywołanie synchroniczne GetColumnSchema(DbDataReader) i zwraca ukończone zadanie. Domyślna implementacja zwróci anulowane zadanie, jeśli zostało już anulowane cancellationToken. Wyjątki zgłaszane przez GetColumnSchema(DbDataReader) program będą przekazywane za pośrednictwem zwróconej właściwości Wyjątek zadania. (Odziedziczone po DbDataReader)
GetData(Int32)	Zwraca zagnieżdżony czytnik danych dla żądanej kolumny. (Odziedziczone po DbDataReader)
GetDataTypeName(Int32)	Pobiera ciąg reprezentujący typ danych określonej kolumny.
GetDateTime(Int32)	Pobiera wartość określonej kolumny jako DateTime obiekt.
GetDbDataReader(Int32)	DbDataReader Zwraca obiekt żądanej kolumny porządkowej, który można zastąpić implementacją specyficzną dla dostawcy. (Odziedziczone po DbDataReader)
GetDecimal(Int32)	Pobiera wartość określonej kolumny jako Decimal.
GetDouble(Int32)	Pobiera wartość kolumny jako liczbę zmiennoprzecinkową o podwójnej precyzji.
GetEnumerator()	Zwraca moduł wyliczający, który może służyć do iterowania po kolekcji elementów.
GetFieldType(Int32)	Type Pobiera typ danych obiektu .
GetFieldValue<T>(Int32)	Pobiera wartość określonej kolumny jako żądany typ. (Odziedziczone po DbDataReader)
GetFieldValueAsync<T>(Int32)	Asynchronicznie pobiera wartość określonej kolumny jako żądany typ. (Odziedziczone po DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)	Asynchronicznie pobiera wartość określonej kolumny jako żądany typ. (Odziedziczone po DbDataReader)
GetFloat(Int32)	Pobiera wartość określonej kolumny jako liczbę zmiennoprzecinkową o pojedynczej precyzji.
GetGuid(Int32)	Pobiera wartość określonej kolumny jako unikatowy identyfikator globalny (GUID).
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetInt16(Int32)	Pobiera wartość określonej kolumny jako 16-bitową liczbę całkowitą ze znakiem.
GetInt32(Int32)	Pobiera wartość określonej kolumny jako 32-bitową liczbę całkowitą ze znakiem.
GetInt64(Int32)	Pobiera wartość określonej kolumny jako 64-bitową liczbę całkowitą ze znakiem.
GetLifetimeService()	Nieaktualne. Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetName(Int32)	Pobiera wartość określonej kolumny jako String.
GetOrdinal(String)	Pobiera porządkową kolumnę, podając nazwę kolumny.
GetProviderSpecificFieldType(Int32)	Pobiera typ określonej kolumny w formacie specyficznym dla dostawcy.
GetProviderSpecificValue(Int32)	Pobiera wartość określonej kolumny w formacie specyficznym dla dostawcy.
GetProviderSpecificValues(Object[])	Wypełnia dostarczoną tablicę informacjami o typie specyficznym dla dostawcy dla wszystkich kolumn w obiekcie DataTableReader.
GetSchemaTable()	Zwraca obiekt DataTable , który opisuje metadane kolumny elementu DataTableReader.
GetSchemaTableAsync(CancellationToken)	Jest to asynchroniczna wersja programu GetSchemaTable(). Dostawcy powinni zastąpić odpowiednią implementacją. cancellationToken Opcjonalnie można je honorować. Domyślna implementacja wywołuje wywołanie synchroniczne GetSchemaTable() i zwraca ukończone zadanie. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazano już anulowane cancellationToken. Wyjątki zgłoszone przez GetSchemaTable() program będą przekazywane za pośrednictwem zwróconej właściwości Wyjątki zadania. (Odziedziczone po DbDataReader)
GetStream(Int32)	Pobiera strumień do pobierania danych z określonej kolumny. (Odziedziczone po DbDataReader)
GetString(Int32)	Pobiera wartość określonej kolumny jako ciąg.
GetTextReader(Int32)	Pobiera czytnik tekstu w celu pobrania danych z kolumny. (Odziedziczone po DbDataReader)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
GetValue(Int32)	Pobiera wartość określonej kolumny w formacie natywnym.
GetValues(Object[])	Wypełnia tablicę obiektów wartościami kolumn bieżącego wiersza.
InitializeLifetimeService()	Nieaktualne. Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
IsDBNull(Int32)	Pobiera wartość wskazującą, czy kolumna zawiera nieistniejące, czy brakujące wartości.
IsDBNullAsync(Int32)	Asynchronicznie pobiera wartość wskazującą, czy kolumna zawiera nieistniejące, czy brakujące wartości. (Odziedziczone po DbDataReader)
IsDBNullAsync(Int32, CancellationToken)	Asynchronicznie pobiera wartość wskazującą, czy kolumna zawiera nieistniejące, czy brakujące wartości. (Odziedziczone po DbDataReader)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
NextResult()	Przechodzi do DataTableReader następnego zestawu wyników, jeśli istnieje.
NextResultAsync()	Asynchronicznie przechodzi czytelnika do następnego wyniku podczas odczytywania wyników partii instrukcji. (Odziedziczone po DbDataReader)
NextResultAsync(CancellationToken)	Asynchronicznie przechodzi czytelnika do następnego wyniku podczas odczytywania wyników partii instrukcji. (Odziedziczone po DbDataReader)
Read()	DataTableReader Przechodzi do następnego rekordu.
ReadAsync()	Asynchronicznie zwiększa czytnik do następnego rekordu w zestawie wyników. (Odziedziczone po DbDataReader)
ReadAsync(CancellationToken)	Asynchronicznie zwiększa czytnik do następnego rekordu w zestawie wyników. (Odziedziczone po DbDataReader)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

IDataRecord.GetData(Int32)

Aby uzyskać opis tego członka, zobacz GetData(Int32). (Odziedziczone po DbDataReader)

Metody rozszerzania

CanGetColumnSchema(DbDataReader)	Pobiera wartość wskazującą, czy DbDataReader można uzyskać schemat kolumny.
GetColumnSchema(DbDataReader)	Pobiera schemat kolumny (DbColumn kolekcja) dla elementu DbDataReader.
GetBoolean(DbDataReader, String)	Pobiera wartość określonej kolumny jako wartość logiczną.
GetByte(DbDataReader, String)	Pobiera wartość określonej kolumny jako bajt.
GetBytes(DbDataReader, String, Int64, Byte[], Int32, Int32)	Odczytuje określoną liczbę bajtów z określonej kolumny rozpoczynającej się od określonego indeksu i zapisuje je w buforze rozpoczynającym się od określonej pozycji w buforze.
GetChar(DbDataReader, String)	Pobiera wartość określonej kolumny jako pojedynczy znak.
GetChars(DbDataReader, String, Int64, Char[], Int32, Int32)	Odczytuje określoną liczbę znaków z określonej kolumny rozpoczynającej się od określonego indeksu i zapisuje je w buforze rozpoczynającym się na określonej pozycji.
GetData(DbDataReader, String)	Zwraca zagnieżdżony czytnik danych dla żądanej kolumny.
GetDataTypeName(DbDataReader, String)	Pobiera nazwę typu danych określonej kolumny.
GetDateTime(DbDataReader, String)	Pobiera wartość określonej kolumny jako DateTime obiekt.
GetDecimal(DbDataReader, String)	Pobiera wartość określonej kolumny jako Decimal.
GetDouble(DbDataReader, String)	Pobiera wartość określonej kolumny jako liczbę zmiennoprzecinkową o podwójnej precyzji.
GetFieldType(DbDataReader, String)	Pobiera typ danych określonej kolumny.
GetFieldValue<T>(DbDataReader, String)	Pobiera wartość określonej kolumny jako żądany typ.
GetFieldValueAsync<T>(DbDataReader, String, CancellationToken)	Asynchronicznie pobiera wartość określonej kolumny jako żądany typ.
GetFloat(DbDataReader, String)	Pobiera wartość określonej kolumny jako liczbę zmiennoprzecinkową o pojedynczej precyzji.
GetGuid(DbDataReader, String)	Pobiera wartość określonej kolumny jako unikatowy identyfikator globalny (GUID).
GetInt16(DbDataReader, String)	Pobiera wartość określonej kolumny jako 16-bitową liczbę całkowitą podpisaną.
GetInt32(DbDataReader, String)	Pobiera wartość określonej kolumny jako 32-bitową liczbę całkowitą podpisaną.
GetInt64(DbDataReader, String)	Pobiera wartość określonej kolumny jako 64-bitową liczbę całkowitą podpisaną.
GetProviderSpecificFieldType(DbDataReader, String)	Pobiera typ specyficzny dla dostawcy określonej kolumny.
GetProviderSpecificValue(DbDataReader, String)	Pobiera wartość określonej kolumny jako wystąpienie typu specyficznego dla dostawcy.
GetStream(DbDataReader, String)	Pobiera strumień do pobierania danych z określonej kolumny.
GetString(DbDataReader, String)	Pobiera wartość określonej kolumny jako wystąpienie klasy String.
GetTextReader(DbDataReader, String)	Pobiera czytnik tekstu w celu pobrania danych z kolumny.
GetValue(DbDataReader, String)	Pobiera wartość określonej kolumny jako wystąpienie klasy Object.
IsDBNull(DbDataReader, String)	Pobiera wartość wskazującą, czy kolumna zawiera nieistniejące, czy brakujące wartości.
IsDBNullAsync(DbDataReader, String, CancellationToken)	Asynchronicznie pobiera wartość wskazującą, czy kolumna zawiera nieistniejące, czy brakujące wartości.
Cast<TResult>(IEnumerable)	Rzutuje elementy elementu IEnumerable na określony typ.
OfType<TResult>(IEnumerable)	Filtruje elementy IEnumerable elementu na podstawie określonego typu.
AsParallel(IEnumerable)	Umożliwia równoległość zapytania.
AsQueryable(IEnumerable)	Konwertuje element IEnumerable na .IQueryable
ConfigureAwait(IAsyncDisposable, Boolean)	Konfiguruje sposób oczekiwania na zadania zwracane z jednorazowego użytku asynchronicznego.