DataTableReader Klasa

Definicja

Przestrzeń nazw:

System.Data

Zestaw:

System.Data.Common.dll

Źródło:

DataTableReader.cs

DataTableReader uzyskuje zawartość co najmniej jednego obiektu DataTable w postaci co najmniej jednego zestawu 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

DataTableReader działa podobnie jak każdy inny czytnik danych, taki jak SqlDataReader, z tą różnicą, że DataTableReader zapewnia iterowanie wierszy w DataTable. Innymi słowy, zapewnia iterację wierszy w pamięci podręcznej. Buforowane dane można modyfikować, gdy DataTableReader są aktywne, a czytelnik automatycznie zachowuje swoje stanowisko.

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

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

DataTableReader zapewnia stabilną iterator; oznacza to, że zawartość DataTableReader nie jest unieważniona, jeśli rozmiar kolekcji bazowej jest modyfikowany podczas iteracji. Jeśli na przykład co najmniej jeden wiersz w kolekcji Rows zostanie usunięty lub usunięty podczas iteracji, bieżące położenie w DataTableReader zostanie odpowiednio zachowane i nie unieważnia iteratora.

Konstruktory

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

Właściwości

Depth	Głębokość zagnieżdżania bieżącego wiersza DataTableReader.
FieldCount	Zwraca liczbę kolumn w bieżącym wierszu.
HasRows	Pobiera wartość wskazującą, czy DataTableReader zawiera jeden lub więcej wierszy.
IsClosed	Pobiera wartość wskazującą, czy DataTableReader jest zamknięta.
Item[Int32]	Pobiera wartość określonej kolumny w formacie natywnym, biorąc pod uwagę porządkowość 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 DbDataReader, które nie są ukryte. (Odziedziczone po DbDataReader)

Metody

Close()	Zamyka bieżącą DataTableReader.
CloseAsync()	Asynchronicznie zamyka obiekt DbDataReader. (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 niezarządzane zasoby używane przez DbDataReader i opcjonalnie zwalnia zarządzane zasoby. (Odziedziczone po DbDataReader)
DisposeAsync()	Asynchronicznie zwalnia wszystkie zasoby używane przez bieżące wystąpienie klasy DbDataReader. (Odziedziczone po DbDataReader)
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (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 tablica rozpoczynająca 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 GetColumnSchema(DbDataReader). Dostawcy powinni zastąpić odpowiednią implementacją. cancellationToken można opcjonalnie honorować. Domyślna implementacja wywołuje synchroniczne wywołanie 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) 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 obiekt DateTime.
GetDbDataReader(Int32)	Zwraca obiekt DbDataReader dla żądanej porządkowej kolumny, którą 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)	Pobiera Type, który jest typem danych obiektu.
GetFieldValue<T>(Int32)	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)
GetFieldValueAsync<T>(Int32)	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 globalnie unikatowy identyfikator (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()	Przestarzałe. 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ę, biorąc pod uwagę 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 podaną tablicę informacjami o typie specyficznym dla dostawcy dla wszystkich kolumn w DataTableReader.
GetSchemaTable()	Zwraca DataTable opisujący metadane kolumny DataTableReader.
GetSchemaTableAsync(CancellationToken)	Jest to asynchroniczna wersja GetSchemaTable(). Dostawcy powinni zastąpić odpowiednią implementacją. cancellationToken można opcjonalnie honorować. Domyślna implementacja wywołuje synchroniczne wywołanie GetSchemaTable() i zwraca ukończone zadanie. Domyślna implementacja zwróci anulowane zadanie, jeśli zostało już anulowane cancellationToken. Wyjątki zgłaszane przez GetSchemaTable() będą przekazywane za pośrednictwem zwróconej właściwości Wyjątek 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()	Pobiera Type 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()	Przestarzałe. 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, CancellationToken)	Asynchronicznie pobiera wartość wskazującą, czy kolumna zawiera nieistniejące, czy brakujące wartości. (Odziedziczone po DbDataReader)
IsDBNullAsync(Int32)	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 Object. (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego obiektu MarshalByRefObject. (Odziedziczone po MarshalByRefObject)
NextResult()	Przechodzi DataTableReader do następnego zestawu wyników, jeśli istnieje.
NextResultAsync()	Asynchronicznie zwiększa czytelnika do następnego wyniku podczas odczytywania wyników partii instrukcji. (Odziedziczone po DbDataReader)
NextResultAsync(CancellationToken)	Asynchronicznie zwiększa czytelnika do następnego wyniku podczas odczytywania wyników partii instrukcji. (Odziedziczone po DbDataReader)
Read()	Przechodzi DataTableReader do następnego rekordu.
ReadAsync()	Asynchronicznie zwiększa czytelnika do następnego rekordu w zestawie wyników. (Odziedziczone po DbDataReader)
ReadAsync(CancellationToken)	Asynchronicznie zwiększa czytelnika 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 elementu członkowskiego, zobacz GetData(Int32). (Odziedziczone po DbDataReader)

Metody rozszerzania

CanGetColumnSchema(DbDataReader)	Pobiera wartość wskazującą, czy DbDataReader może uzyskać schemat kolumny.
GetColumnSchema(DbDataReader)	Pobiera schemat kolumny (kolekcjaDbColumn) dla 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ę od 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 obiekt DateTime.
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 globalnie unikatowy identyfikator (GUID).
GetInt16(DbDataReader, String)	Pobiera wartość określonej kolumny jako 16-bitową liczbę całkowitą ze znakiem.
GetInt32(DbDataReader, String)	Pobiera wartość określonej kolumny jako 32-bitową liczbę całkowitą ze znakiem.
GetInt64(DbDataReader, String)	Pobiera wartość określonej kolumny jako 64-bitową liczbę całkowitą ze znakiem.
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 String.
GetTextReader(DbDataReader, String)	Pobiera czytnik tekstu w celu pobrania danych z kolumny.
GetValue(DbDataReader, String)	Pobiera wartość określonej kolumny jako wystąpienie 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 IEnumerable do określonego typu.
OfType<TResult>(IEnumerable)	Filtruje elementy IEnumerable na podstawie określonego typu.
AsParallel(IEnumerable)	Umożliwia równoległość zapytania.
AsQueryable(IEnumerable)	Konwertuje IEnumerable na IQueryable.
ConfigureAwait(IAsyncDisposable, Boolean)	Konfiguruje, w jaki sposób będą wykonywane oczekiwania na zadania zwrócone z asynchronicznego jednorazowego użytku.