DataTableReader Klasa

Definicja

Przestrzeń nazw:

System.Data

Zestaw:

System.Data.dll

Obiekt DataTableReader uzyskuje zawartość jednego lub więcej obiektów DataTable w postaci jednego lub więcej zestawów wyników tylko do odczytu, tylko w przód.

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 funkcja zapewnia iterację wierszy w obiekcie DataTable. Innymi słowy, zapewnia iterację wierszy w pamięci podręcznej. Buforowane dane można modyfikować, gdy DataTableReader element jest aktywny, a czytelnik automatycznie zachowuje swoje stanowisko.

Podczas tworzenia obiektu DataTableReader na podstawie DataTableobiektu wynikowego DataTableReader zawiera jeden zestaw wyników z tymi samymi danymi, 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 DataTablekolejności . Struktura zwróconego wyniku jest identyczna w schemacie i danych z oryginalnym DataTableelementem . Obiekt DataTableReader utworzony przez wywołanie CreateDataReader metody DataSet obiektu zawiera wiele zestawów wyników, jeśli DataSet zawiera więcej niż jedną tabelę. Wyniki są w tej samej sekwencji co DataTable obiekty w DataTableCollectionDataSet obiekcie .

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

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

Konstruktory

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

Właściwości

Nazwa	Opis
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 DataTableReader element zawiera co najmniej jeden wiersz.
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ę 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 polach DbDataReader , które nie są ukryte. (Odziedziczone po DbDataReader)

Metody

Nazwa	Opis
Close()	Zamyka bieżący element DataTableReader.
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 DbDataReader klasy. (Odziedziczone po DbDataReader)
Dispose(Boolean)	Zwalnia niezarządzane zasoby używane przez DbDataReader program i opcjonalnie zwalnia zarządzane zasoby. (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 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.
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)	Pobiera typ Type 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()	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 dostarczoną tablicę informacjami o typie specyficznym dla dostawcy dla wszystkich kolumn w obiekcie DataTableReader.
GetSchemaTable()	Zwraca element opisujący DataTable metadane kolumny obiektu DataTableReader.
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()	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 MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
NextResult()	Przechodzi do DataTableReader 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()	DataTableReader Przechodzi 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

Nazwa	Opis
IDataRecord.GetData(Int32)	Aby uzyskać opis tego elementu członkowskiego, zobacz GetData(Int32). (Odziedziczone po DbDataReader)

Metody rozszerzania

Nazwa	Opis
AsParallel(IEnumerable)	Umożliwia równoległość zapytania.
AsQueryable(IEnumerable)	Konwertuje IEnumerable na IQueryable.
CanGetColumnSchema(DbDataReader)	Pobiera wartość wskazującą, czy DbDataReader można uzyskać schemat kolumny.
Cast<TResult>(IEnumerable)	Rzutuje elementy IEnumerable do określonego typu.
GetColumnSchema(DbDataReader)	Pobiera schemat kolumny (DbColumn kolekcja) dla elementu DbDataReader.
OfType<TResult>(IEnumerable)	Filtruje elementy IEnumerable na podstawie określonego typu.