DataTableReader Klasa

Definicja

DataTableReader uzyskuje zawartość co najmniej jednego DataTable obiektów w formie co najmniej jednego zestawu wyników tylko do odczytu.The DataTableReader obtains the contents of one or more DataTable objects in the form of one or more read-only, forward-only result sets.

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

Uwagi

DataTableReader działa podobnie jak każdy inny czytnik danych, na przykład SqlDataReader, z tą różnicą, że DataTableReader pozwala na iterację wierszy w DataTable.The DataTableReader works much like any other data reader, such as the SqlDataReader, except that the DataTableReader provides for iterating over rows in a DataTable. Innymi słowy, umożliwia wykonywanie iteracji względem wierszy w pamięci podręcznej.In other words, it provides for iterating over rows in a cache. Buforowane dane można modyfikować, gdy DataTableReader jest aktywny, a czytelnik automatycznie utrzymuje swoją pozycję.The cached data can be modified while the DataTableReader is active, and the reader automatically maintains its position.

Po utworzeniu DataTableReader z DataTable, wynikowy obiekt DataTableReader zawiera jeden zestaw wyników z tymi samymi danymi co DataTable, z którego zostało utworzone, z wyjątkiem wierszy, które zostały oznaczone jako usunięte.When you create a DataTableReader from a DataTable, the resulting DataTableReader object contains one result set with the same data as the DataTable from which it was created, except for any rows that have been marked as deleted. Kolumny są wyświetlane w takiej samej kolejności jak w oryginalnym DataTable.The columns appear in the same order as in the original DataTable. Struktura zwracanego wyniku jest taka sama w schemacie i danych do oryginalnego DataTable.The structure of the returned result is identical in schema and data to the original 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ę.A DataTableReader that was created by calling the CreateDataReader method of a DataSet object contains multiple result sets if the DataSet contains more than one table. Wyniki są w tej samej sekwencji co DataTable obiektów w DataTableCollection obiektu DataSet.The results are in the same sequence as the DataTable objects in the DataTableCollection of the DataSet object.

Zwrócony zestaw wyników zawiera tylko bieżącą wersję poszczególnych DataRow; wiersze oznaczone do usunięcia są pomijane.The returned result set contains only the current version of each DataRow; rows that are marked for deletion are skipped.

DataTableReader zapewnia stabilny iterator; oznacza to, że zawartość DataTableReader nie jest unieważniona, jeśli rozmiar źródłowej kolekcji jest modyfikowany podczas iteracji.The DataTableReader provides a stable iterator; that is, the contents of the DataTableReader are not invalidated if the size of the underlying collection is modified during iteration. Na przykład jeśli co najmniej jeden wiersz w kolekcji Rows jest usuwany lub usuwany podczas iteracji, bieżąca pozycja w DataTableReader jest odpowiednio utrzymywana i nie unieważnia iteratora.For example, if one or more rows in the Rows collection are deleted or removed during iteration, the current position within the DataTableReader is maintained appropriately and it does not invalidate the iterator.

Konstruktory

DataTableReader(DataTable)

Inicjuje nowe wystąpienie klasy DataTableReader przy użyciu danych z podanej DataTable.Initializes a new instance of the DataTableReader class by using data from the supplied DataTable.

DataTableReader(DataTable[])

Inicjuje nowe wystąpienie klasy DataTableReader przy użyciu dostarczonej tablicy obiektów DataTable.Initializes a new instance of the DataTableReader class using the supplied array of DataTable objects.

Właściwości

Depth

Głębokość zagnieżdżenia bieżącego wiersza DataTableReader.The depth of nesting for the current row of the DataTableReader.

FieldCount

Zwraca liczbę kolumn w bieżącym wierszu.Returns the number of columns in the current row.

HasRows

Pobiera wartość wskazującą, czy DataTableReader zawiera jeden lub więcej wierszy.Gets a value that indicates whether the DataTableReader contains one or more rows.

IsClosed

Pobiera wartość wskazującą, czy DataTableReader jest zamknięty.Gets a value that indicates whether the DataTableReader is closed.

Item[Int32]

Pobiera wartość określonej kolumny w formacie natywnym, w którym znajduje się numer porządkowy kolumny.Gets the value of the specified column in its native format given the column ordinal.

Item[String]

Pobiera wartość określonej kolumny w formacie natywnym, w którym znajduje się nazwa kolumny.Gets the value of the specified column in its native format given the column name.

RecordsAffected

Pobiera liczbę wierszy wstawionych, zmienionych lub usuniętych przez wykonanie instrukcji SQL.Gets the number of rows inserted, changed, or deleted by execution of the SQL statement.

VisibleFieldCount

Pobiera liczbę pól w DbDataReader, które nie są ukryte.Gets the number of fields in the DbDataReader that are not hidden.

(Odziedziczone po DbDataReader)

Metody

Close()

Zamyka bieżący DataTableReader.Closes the current DataTableReader.

CloseAsync()

Asynchronicznie zamyka obiekt DbDataReader.Asynchronously closes the DbDataReader object.

(Odziedziczone po DbDataReader)
CreateObjRef(Type)

Tworzy obiekt, który zawiera wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikacji z obiektem zdalnym.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Odziedziczone po MarshalByRefObject)
Dispose()

Zwalnia wszystkie zasoby używane przez bieżące wystąpienie klasy DbDataReader.Releases all resources used by the current instance of the DbDataReader class.

(Odziedziczone po DbDataReader)
Dispose(Boolean)

Zwalnia zasoby niezarządzane używane przez element DbDataReader i opcjonalnie zwalnia zasoby zarządzane.Releases the unmanaged resources used by the DbDataReader and optionally releases the managed resources.

(Odziedziczone po DbDataReader)
DisposeAsync()

Asynchronicznie zwalnia wszystkie zasoby używane przez bieżące wystąpienie klasy DbDataReader.Asynchronously releases all resources used by the current instance of the DbDataReader class.

(Odziedziczone po DbDataReader)
Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetBoolean(Int32)

Pobiera wartość określonej kolumny jako Boolean.Gets the value of the specified column as a Boolean.

GetByte(Int32)

Pobiera wartość określonej kolumny jako bajt.Gets the value of the specified column as a byte.

GetBytes(Int32, Int64, Byte[], Int32, Int32)

Odczytuje strumień bajtów, zaczynając od określonego przesunięcia kolumny do bufora jako tablicę rozpoczynającą się od określonego przesunięcia buforu.Reads a stream of bytes starting at the specified column offset into the buffer as an array starting at the specified buffer offset.

GetChar(Int32)

Pobiera wartość określonej kolumny jako znak.Gets the value of the specified column as a character.

GetChars(Int32, Int64, Char[], Int32, Int32)

Zwraca wartość określonej kolumny jako tablicę znaków.Returns the value of the specified column as a character array.

GetData(Int32)

Zwraca zagnieżdżony czytnik danych dla żądanej kolumny.Returns a nested data reader for the requested column.

(Odziedziczone po DbDataReader)
GetDataTypeName(Int32)

Pobiera ciąg reprezentujący typ danych określonej kolumny.Gets a string representing the data type of the specified column.

GetDateTime(Int32)

Pobiera wartość określonej kolumny jako obiekt DateTime.Gets the value of the specified column as a DateTime object.

GetDbDataReader(Int32)

Zwraca obiekt DbDataReader dla numeru porządkowego kolumny, który może zostać zastąpiony przez implementację specyficzną dla dostawcy.Returns a DbDataReader object for the requested column ordinal that can be overridden with a provider-specific implementation.

(Odziedziczone po DbDataReader)
GetDecimal(Int32)

Pobiera wartość określonej kolumny jako Decimal.Gets the value of the specified column as a Decimal.

GetDouble(Int32)

Pobiera wartość kolumny jako liczbę zmiennoprzecinkową o podwójnej precyzji.Gets the value of the column as a double-precision floating point number.

GetEnumerator()

Zwraca moduł wyliczający, który może być używany do iteracji w kolekcji elementów.Returns an enumerator that can be used to iterate through the item collection.

GetFieldType(Int32)

Pobiera Type, który jest typem danych obiektu.Gets the Type that is the data type of the object.

GetFieldValue<T>(Int32)

Pobiera wartość określonej kolumny jako żądany typ.Gets the value of the specified column as the requested type.

(Odziedziczone po DbDataReader)
GetFieldValueAsync<T>(Int32)

Asynchronicznie Pobiera wartość określonej kolumny jako żądany typ.Asynchronously gets the value of the specified column as the requested type.

(Odziedziczone po DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)

Asynchronicznie Pobiera wartość określonej kolumny jako żądany typ.Asynchronously gets the value of the specified column as the requested type.

(Odziedziczone po DbDataReader)
GetFloat(Int32)

Pobiera wartość określonej kolumny jako liczbę zmiennoprzecinkową o pojedynczej precyzji.Gets the value of the specified column as a single-precision floating point number.

GetGuid(Int32)

Pobiera wartość określonej kolumny jako unikatowy identyfikator globalny (GUID).Gets the value of the specified column as a globally-unique identifier (GUID).

GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetInt16(Int32)

Pobiera wartość określonej kolumny jako 16-bitową liczbę całkowitą ze znakiem.Gets the value of the specified column as a 16-bit signed integer.

GetInt32(Int32)

Pobiera wartość określonej kolumny jako 32-bitową liczbę całkowitą ze znakiem.Gets the value of the specified column as a 32-bit signed integer.

GetInt64(Int32)

Pobiera wartość określonej kolumny jako 64-bitową liczbę całkowitą ze znakiem.Gets the value of the specified column as a 64-bit signed integer.

GetLifetimeService()

Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
GetName(Int32)

Pobiera wartość określonej kolumny jako String.Gets the value of the specified column as a String.

GetOrdinal(String)

Pobiera numer porządkowy kolumny, uwzględniając nazwę kolumny.Gets the column ordinal, given the name of the column.

GetProviderSpecificFieldType(Int32)

Pobiera typ określonej kolumny w formacie specyficznym dla dostawcy.Gets the type of the specified column in provider-specific format.

GetProviderSpecificValue(Int32)

Pobiera wartość określonej kolumny w formacie specyficznym dla dostawcy.Gets the value of the specified column in provider-specific format.

GetProviderSpecificValues(Object[])

Wypełnia podaną tablicę informacjami o typie specyficznym dla dostawcy dla wszystkich kolumn w DataTableReader.Fills the supplied array with provider-specific type information for all the columns in the DataTableReader.

GetSchemaTable()

Zwraca DataTable, który opisuje metadane kolumn DataTableReader.Returns a DataTable that describes the column metadata of the DataTableReader.

GetStream(Int32)

Pobiera strumień służący do pobierania danych z określonej kolumny.Gets a stream to retrieve data from the specified column.

(Odziedziczone po DbDataReader)
GetString(Int32)

Pobiera wartość określonej kolumny jako ciąg.Gets the value of the specified column as a string.

GetTextReader(Int32)

Pobiera czytnik tekstu służący do pobierania danych z kolumny.Gets a text reader to retrieve data from the column.

(Odziedziczone po DbDataReader)
GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
GetValue(Int32)

Pobiera wartość określonej kolumny w formacie natywnym.Gets the value of the specified column in its native format.

GetValues(Object[])

Wypełnia tablicę obiektów wartościami kolumn bieżącego wiersza.Populates an array of objects with the column values of the current row.

InitializeLifetimeService()

Uzyskuje obiekt usługi istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
IsDBNull(Int32)

Pobiera wartość wskazującą, czy kolumna zawiera nieistniejące lub brakujące wartości.Gets a value that indicates whether the column contains non-existent or missing values.

IsDBNullAsync(Int32)

Asynchronicznie Pobiera wartość wskazującą, czy kolumna zawiera nieistniejące lub brakujące wartości.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

(Odziedziczone po DbDataReader)
IsDBNullAsync(Int32, CancellationToken)

Asynchronicznie Pobiera wartość wskazującą, czy kolumna zawiera nieistniejące lub brakujące wartości.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

(Odziedziczone po DbDataReader)
MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy skróconą kopię bieżącego obiektu MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Odziedziczone po MarshalByRefObject)
NextResult()

Zwiększa DataTableReader do następnego zestawu wyników, jeśli istnieje.Advances the DataTableReader to the next result set, if any.

NextResultAsync()

Asynchronicznie przesuwa czytnik do następnego wyniku podczas odczytywania wyników partii instrukcji.Asynchronously advances the reader to the next result when reading the results of a batch of statements.

(Odziedziczone po DbDataReader)
NextResultAsync(CancellationToken)

Asynchronicznie przesuwa czytnik do następnego wyniku podczas odczytywania wyników partii instrukcji.Asynchronously advances the reader to the next result when reading the results of a batch of statements.

(Odziedziczone po DbDataReader)
Read()

Przechodzi do następnego rekordu DataTableReader.Advances the DataTableReader to the next record.

ReadAsync()

Asynchronicznie przesuwa czytnik do następnego rekordu w zestawie wyników.Asynchronously advances the reader to the next record in a result set.

(Odziedziczone po DbDataReader)
ReadAsync(CancellationToken)

Asynchronicznie przesuwa czytnik do następnego rekordu w zestawie wyników.Asynchronously advances the reader to the next record in a result set.

(Odziedziczone po DbDataReader)
ToString()

Zwraca ciąg, który reprezentuje bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Jawne implementacje interfejsu

IDataReader.Close()

Aby uzyskać opis tego elementu członkowskiego, zobacz Close().For a description of this member, see Close().

(Odziedziczone po DbDataReader)
IDataReader.GetSchemaTable()

Aby uzyskać opis tego elementu członkowskiego, zobacz GetSchemaTable().For a description of this member, see GetSchemaTable().

(Odziedziczone po DbDataReader)
IDataRecord.GetData(Int32)

Aby uzyskać opis tego elementu członkowskiego, zobacz GetData(Int32).For a description of this member, see GetData(Int32).

(Odziedziczone po DbDataReader)

Metody rozszerzania

CanGetColumnSchema(DbDataReader)

Pobiera wartość wskazującą, czy DbDataReader może uzyskać schemat kolumny.Gets a value that indicates whether a DbDataReader can get a column schema.

GetColumnSchema(DbDataReader)

Pobiera schemat kolumny (kolekcjaDbColumn) dla DbDataReader.Gets the column schema (DbColumn collection) for a DbDataReader.

GetBoolean(DbDataReader, String)

Pobiera wartość określonej kolumny jako wartość logiczną.Gets the value of the specified column as a Boolean.

GetByte(DbDataReader, String)

Pobiera wartość określonej kolumny jako bajt.Gets the value of the specified column as a byte.

GetBytes(DbDataReader, String, Int64, Byte[], Int32, Int32)

Odczytuje określoną liczbę bajtów z określonej kolumny, rozpoczynając od określonego indeksu i zapisuje je w buforze, rozpoczynając od określonej pozycji w buforze.Reads a specified number of bytes from the specified column starting at a specified index and writes them to a buffer starting at a specified position in the buffer.

GetChar(DbDataReader, String)

Pobiera wartość określonej kolumny jako pojedynczy znak.Gets the value of the specified column as a single character.

GetChars(DbDataReader, String, Int64, Char[], Int32, Int32)

Odczytuje określoną liczbę znaków z określonej kolumny, zaczynając od określonego indeksu, i zapisuje je w buforze, rozpoczynając od określonej pozycji.Reads a specified number of characters from a specified column starting at a specified index, and writes them to a buffer starting at a specified position.

GetData(DbDataReader, String)

Zwraca zagnieżdżony czytnik danych dla żądanej kolumny.Returns a nested data reader for the requested column.

GetDataTypeName(DbDataReader, String)

Pobiera nazwę typu danych dla określonej kolumny.Gets name of the data type of the specified column.

GetDateTime(DbDataReader, String)

Pobiera wartość określonej kolumny jako obiekt DateTime.Gets the value of the specified column as a DateTime object.

GetDecimal(DbDataReader, String)

Pobiera wartość określonej kolumny jako Decimal.Gets the value of the specified column as a Decimal.

GetDouble(DbDataReader, String)

Pobiera wartość określonej kolumny jako liczbę zmiennoprzecinkową o podwójnej precyzji.Gets the value of the specified column as a double-precision floating point number.

GetFieldType(DbDataReader, String)

Pobiera typ danych dla określonej kolumny.Gets the data type of the specified column.

GetFieldValue<T>(DbDataReader, String)

Pobiera wartość określonej kolumny jako żądany typ.Gets the value of the specified column as the requested type.

GetFieldValueAsync<T>(DbDataReader, String, CancellationToken)

Asynchronicznie Pobiera wartość określonej kolumny jako żądany typ.Asynchronously gets the value of the specified column as the requested type.

GetFloat(DbDataReader, String)

Pobiera wartość określonej kolumny jako liczbę zmiennoprzecinkową o pojedynczej precyzji.Gets the value of the specified column as a single-precision floating point number.

GetGuid(DbDataReader, String)

Pobiera wartość określonej kolumny jako unikatowy identyfikator globalny (GUID).Gets the value of the specified column as a globally unique identifier (GUID).

GetInt16(DbDataReader, String)

Pobiera wartość określonej kolumny jako 16-bitową liczbę całkowitą ze znakiem.Gets the value of the specified column as a 16-bit signed integer.

GetInt32(DbDataReader, String)

Pobiera wartość określonej kolumny jako 32-bitową liczbę całkowitą ze znakiem.Gets the value of the specified column as a 32-bit signed integer.

GetInt64(DbDataReader, String)

Pobiera wartość określonej kolumny jako 64-bitową liczbę całkowitą ze znakiem.Gets the value of the specified column as a 64-bit signed integer.

GetProviderSpecificFieldType(DbDataReader, String)

Pobiera typ specyficzny dla dostawcy dla określonej kolumny.Gets the provider-specific type of the specified column.

GetProviderSpecificValue(DbDataReader, String)

Pobiera wartość określonej kolumny jako wystąpienie typu określonego dla dostawcy.Gets the value of the specified column as an instance of a provider-specific type.

GetStream(DbDataReader, String)

Pobiera strumień służący do pobierania danych z określonej kolumny.Gets a stream to retrieve data from the specified column.

GetString(DbDataReader, String)

Pobiera wartość określonej kolumny jako wystąpienie String.Gets the value of the specified column as an instance of String.

GetTextReader(DbDataReader, String)

Pobiera czytnik tekstu służący do pobierania danych z kolumny.Gets a text reader to retrieve data from the column.

GetValue(DbDataReader, String)

Pobiera wartość określonej kolumny jako wystąpienie Object.Gets the value of the specified column as an instance of Object.

IsDBNull(DbDataReader, String)

Pobiera wartość wskazującą, czy kolumna zawiera nieistniejące lub brakujące wartości.Gets a value that indicates whether the column contains nonexistent or missing values.

IsDBNullAsync(DbDataReader, String, CancellationToken)

Asynchronicznie Pobiera wartość wskazującą, czy kolumna zawiera nieistniejące lub brakujące wartości.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

Cast<TResult>(IEnumerable)

Rzutuje elementy IEnumerable określonego typu.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtruje elementy IEnumerable w oparciu o określony typ.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Włącza przetwarzanie równoległe zapytania.Enables parallelization of a query.

AsQueryable(IEnumerable)

Konwertuje IEnumerable na IQueryable.Converts an IEnumerable to an IQueryable.

Dotyczy