DataTableReader Klasa

Definicja

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

DataTableReaderDziała podobnie jak każdy inny czytnik danych, taki jak SqlDataReader , z tym wyjątkiem, ż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. Dane w pamięci podręcznej można modyfikować DataTableReader , gdy jest aktywny, a czytnik automatycznie utrzymuje swoją pozycję.The cached data can be modified while the DataTableReader is active, and the reader automatically maintains its position.

Podczas tworzenia DataTableReader z DataTable , wynikowy DataTableReader obiekt zawiera jeden zestaw wyników z tymi samymi danymi, DataTable które zostały 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 identyczna w schemacie i danych z oryginałem DataTable .The structure of the returned result is identical in schema and data to the original DataTable. DataTableReaderObiekt, który został utworzony przez wywołanie CreateDataReader metody DataSet obiektu 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 obiekty w DataTableCollection DataSet obiekcie.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ę każdego z nich 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.

DataTableReaderZapewnia 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 Rows kolekcji jest usuwany lub usuwany podczas iteracji, bieżąca pozycja w ramach programu 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 DataTableReader klasy przy użyciu danych z podanego elementu DataTable .Initializes a new instance of the DataTableReader class by using data from the supplied DataTable.

DataTableReader(DataTable[])

Inicjuje nowe wystąpienie DataTableReader klasy za pomocą podanej tablicy DataTable obiektów.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 dla 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 DbDataReader obiekt.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 DbDataReader klasy.Asynchronously releases all resources used by the current instance of the DbDataReader class.

(Odziedziczone po DbDataReader)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.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.

GetColumnSchemaAsync(CancellationToken)

Jest to asynchroniczna wersja programu GetColumnSchema(DbDataReader) .This is the asynchronous version of GetColumnSchema(DbDataReader). Dostawcy powinny zastępować odpowiednie implementacje.Providers should override with an appropriate implementation. cancellationTokenOpcjonalnie można uznać.The cancellationToken can optionally be honored. Implementacja domyślna wywołuje GetColumnSchema(DbDataReader) wywołanie synchroniczne i zwraca ukończone zadanie.The default implementation invokes the synchronous GetColumnSchema(DbDataReader) call and returns a completed task. Domyślna implementacja zwróci anulowane zadanie, jeśli zostało zakończone cancellationToken .The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Wyjątki zgłoszone przez GetColumnSchema(DbDataReader) program będą przekazywane przez zwracaną Właściwość wyjątku zadania.Exceptions thrown by GetColumnSchema(DbDataReader) will be communicated via the returned Task Exception property.

(Odziedziczone po DbDataReader)
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 DateTime obiekt.Gets the value of the specified column as a DateTime object.

GetDbDataReader(Int32)

Zwraca DbDataReader obiekt 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()
Nieaktualne.

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.

GetSchemaTableAsync(CancellationToken)

Jest to asynchroniczna wersja programu GetSchemaTable() .This is the asynchronous version of GetSchemaTable(). Dostawcy powinny zastępować odpowiednie implementacje.Providers should override with an appropriate implementation. cancellationTokenOpcjonalnie można uznać.The cancellationToken can optionally be honored. Implementacja domyślna wywołuje GetSchemaTable() wywołanie synchroniczne i zwraca ukończone zadanie.The default implementation invokes the synchronous GetSchemaTable() call and returns a completed task. Domyślna implementacja zwróci anulowane zadanie, jeśli zostało zakończone cancellationToken .The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Wyjątki zgłoszone przez GetSchemaTable() program będą przekazywane przez zwracaną Właściwość wyjątku zadania.Exceptions thrown by GetSchemaTable() will be communicated via the returned Task Exception property.

(Odziedziczone po DbDataReader)
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żące wystąpienie.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()
Nieaktualne.

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 elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
MemberwiseClone(Boolean)

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

(Odziedziczone po MarshalByRefObject)
NextResult()

Przechodzi 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 DataTableReader do następnego rekordu.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 reprezentujący 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żna uzyskać schemat kolumny.Gets a value that indicates whether a DbDataReader can get a column schema.

GetColumnSchema(DbDataReader)

Pobiera schemat kolumny ( DbColumn kolekcję) 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 DateTime obiekt.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 elementu 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 elementu 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 elementu IEnumerable do 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 do IQueryable .Converts an IEnumerable to an IQueryable.

ConfigureAwait(IAsyncDisposable, Boolean)

Określa, jak oczekują oczekiwania na zadania zwracane z asynchronicznej operacji tworzenia.Configures how awaits on the tasks returned from an async disposable are performed.

Dotyczy