DataTableReader Класс

Определение

Пространство имен:

System.Data

Сборки:

netstandard.dll, System.Data.Common.dll

Исходный код:

DataTableReader.cs

DataTableReader получает содержимое одного или нескольких объектов DataTable в виде одного или нескольких наборов результатов только для чтения.

C#

public sealed class DataTableReader : System.Data.Common.DbDataReader

Наследование

Object

MarshalByRefObject

DbDataReader

DataTableReader

Комментарии

DataTableReader работает так же, как и любой другой модуль чтения данных, например SqlDataReader, за исключением того, что DataTableReader обеспечивает итерацию по строкам в DataTable. Другими словами, он обеспечивает итерацию по строкам в кэше. Кэшированные данные можно изменить, пока DataTableReader активен, а средство чтения автоматически сохраняет свое положение.

При создании DataTableReader из DataTableрезультирующий объект DataTableReader содержит один результирующий набор с теми же данными, что и DataTable, из которых он был создан, за исключением строк, помеченных как удаленные. Столбцы отображаются в том же порядке, что и в исходном DataTable. Структура возвращаемого результата идентична схеме и данным исходного DataTable. DataTableReader, созданный путем вызова метода CreateDataReader объекта DataSet, содержит несколько результирующих наборов, если DataSet содержит несколько таблиц. Результаты находятся в той же последовательности, что и объекты DataTable в DataTableCollection объекта DataSet.

Возвращаемый результирующий набор содержит только текущую версию каждого DataRow; Строки, помеченные для удаления, пропускаются.

DataTableReader предоставляет стабильный итератор; То есть содержимое DataTableReader не является недействительным, если размер базовой коллекции изменяется во время итерации. Например, если одна или несколько строк в коллекции Rows удаляются или удаляются во время итерации, текущая позиция в DataTableReader сохраняется соответствующим образом, и она не делает итератор недействительным.

Конструкторы

DataTableReader(DataTable)	Инициализирует новый экземпляр класса DataTableReader с помощью данных из предоставленного DataTable.
DataTableReader(DataTable[])	Инициализирует новый экземпляр класса DataTableReader с помощью предоставленного массива объектов DataTable.

Свойства

Depth	Глубина вложения для текущей строки DataTableReader.
FieldCount	Возвращает количество столбцов в текущей строке.
HasRows	Возвращает значение, указывающее, содержит ли DataTableReader одну или несколько строк.
IsClosed	Возвращает значение, указывающее, закрыт ли DataTableReader.
Item[Int32]	Возвращает значение указанного столбца в собственном формате, учитывая порядковый номер столбца.
Item[String]	Возвращает значение указанного столбца в собственном формате с именем столбца.
RecordsAffected	Возвращает количество строк, вставленных, измененных или удаленных при выполнении инструкции SQL.
VisibleFieldCount	Возвращает количество полей в DbDataReader, которые не скрыты. (Унаследовано от DbDataReader)

Методы

Close()	Закрывает текущий DataTableReader.
CloseAsync()	Асинхронно закрывает объект DbDataReader. (Унаследовано от DbDataReader)
Dispose()	Освобождает все ресурсы, используемые текущим экземпляром класса DbDataReader. (Унаследовано от DbDataReader)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые DbDataReader, и при необходимости освобождает управляемые ресурсы. (Унаследовано от DbDataReader)
DisposeAsync()	Асинхронно освобождает все ресурсы, используемые текущим экземпляром класса DbDataReader. (Унаследовано от DbDataReader)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetBoolean(Int32)	Возвращает значение указанного столбца в виде Boolean.
GetByte(Int32)	Возвращает значение указанного столбца в виде байта.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Считывает поток байтов, начиная с смещения указанного столбца, в буфер в виде массива, начиная с указанного смещения буфера.
GetChar(Int32)	Возвращает значение указанного столбца в виде символа.
GetChars(Int32, Int64, Char[], Int32, Int32)	Возвращает значение указанного столбца в виде массива символов.
GetColumnSchemaAsync(CancellationToken)	Это асинхронная версия GetColumnSchema(DbDataReader). Поставщики должны переопределить соответствующую реализацию. cancellationToken можно при необходимости учитывать. Реализация по умолчанию вызывает синхронный вызов GetColumnSchema(DbDataReader) и возвращает завершенную задачу. Реализация по умолчанию возвращает отмененную задачу при передаче уже отмененной cancellationToken. Исключения, создаваемые GetColumnSchema(DbDataReader), будут передаваться через возвращаемое свойство "Исключение задачи". (Унаследовано от DbDataReader)
GetData(Int32)	Возвращает вложенное средство чтения данных для запрошенного столбца. (Унаследовано от DbDataReader)
GetDataTypeName(Int32)	Возвращает строку, представляющую тип данных указанного столбца.
GetDateTime(Int32)	Возвращает значение указанного столбца в качестве объекта DateTime.
GetDbDataReader(Int32)	Возвращает объект DbDataReader для запрошенного порядкового номера столбца, который можно переопределить с помощью реализации для конкретного поставщика. (Унаследовано от DbDataReader)
GetDecimal(Int32)	Возвращает значение указанного столбца в виде Decimal.
GetDouble(Int32)	Возвращает значение столбца в виде числа с плавающей запятой двойной точности.
GetEnumerator()	Возвращает перечислитель, который можно использовать для итерации через коллекцию элементов.
GetFieldType(Int32)	Возвращает Type, который является типом данных объекта.
GetFieldValue<T>(Int32)	Возвращает значение указанного столбца в качестве запрошенного типа. (Унаследовано от DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)	Асинхронно получает значение указанного столбца в качестве запрошенного типа. (Унаследовано от DbDataReader)
GetFieldValueAsync<T>(Int32)	Асинхронно получает значение указанного столбца в качестве запрошенного типа. (Унаследовано от DbDataReader)
GetFloat(Int32)	Возвращает значение указанного столбца в виде числа с плавающей запятой с одной точностью.
GetGuid(Int32)	Возвращает значение указанного столбца в виде глобально уникального идентификатора (GUID).
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetInt16(Int32)	Возвращает значение указанного столбца в виде 16-разрядного целого числа со знаком.
GetInt32(Int32)	Возвращает значение указанного столбца в виде 32-разрядного целого числа со знаком.
GetInt64(Int32)	Возвращает значение указанного столбца в виде 64-разрядного целого числа со знаком.
GetLifetimeService()	Устаревшие.. Извлекает текущий объект службы времени существования, который управляет политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
GetName(Int32)	Возвращает значение указанного столбца в виде String.
GetOrdinal(String)	Получает порядковый номер столбца с именем столбца.
GetProviderSpecificFieldType(Int32)	Возвращает тип указанного столбца в формате для конкретного поставщика.
GetProviderSpecificValue(Int32)	Возвращает значение указанного столбца в формате, определенном поставщиком.
GetProviderSpecificValues(Object[])	Заполняет предоставленный массив сведениями о типе для конкретного поставщика для всех столбцов в DataTableReader.
GetSchemaTable()	Возвращает DataTable, описывающий метаданные столбца DataTableReader.
GetSchemaTableAsync(CancellationToken)	Это асинхронная версия GetSchemaTable(). Поставщики должны переопределить соответствующую реализацию. cancellationToken можно при необходимости учитывать. Реализация по умолчанию вызывает синхронный вызов GetSchemaTable() и возвращает завершенную задачу. Реализация по умолчанию возвращает отмененную задачу при передаче уже отмененной cancellationToken. Исключения, создаваемые GetSchemaTable(), будут передаваться через возвращаемое свойство "Исключение задачи". (Унаследовано от DbDataReader)
GetStream(Int32)	Получает поток для получения данных из указанного столбца. (Унаследовано от DbDataReader)
GetString(Int32)	Возвращает значение указанного столбца в виде строки.
GetTextReader(Int32)	Получает средство чтения текста для получения данных из столбца. (Унаследовано от DbDataReader)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
GetValue(Int32)	Возвращает значение указанного столбца в собственном формате.
GetValues(Object[])	Заполняет массив объектов значениями столбцов текущей строки.
InitializeLifetimeService()	Устаревшие.. Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
IsDBNull(Int32)	Возвращает значение, указывающее, содержит ли столбец несуществующие или отсутствующие значения.
IsDBNullAsync(Int32, CancellationToken)	Асинхронно получает значение, указывающее, содержит ли столбец отсутствующие или отсутствующие значения. (Унаследовано от DbDataReader)
IsDBNullAsync(Int32)	Асинхронно получает значение, указывающее, содержит ли столбец отсутствующие или отсутствующие значения. (Унаследовано от DbDataReader)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
MemberwiseClone(Boolean)	Создает неглубокую копию текущего объекта MarshalByRefObject. (Унаследовано от MarshalByRefObject)
NextResult()	Перемещает DataTableReader к следующему результирующему набору, если таковой есть.
NextResultAsync()	Асинхронно перемещает средство чтения к следующему результату при чтении результатов пакета инструкций. (Унаследовано от DbDataReader)
NextResultAsync(CancellationToken)	Асинхронно перемещает средство чтения к следующему результату при чтении результатов пакета инструкций. (Унаследовано от DbDataReader)
Read()	Перемещает DataTableReader к следующей записи.
ReadAsync()	Асинхронно перемещает средство чтения к следующей записи в результирующем наборе. (Унаследовано от DbDataReader)
ReadAsync(CancellationToken)	Асинхронно перемещает средство чтения к следующей записи в результирующем наборе. (Унаследовано от DbDataReader)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

Явные реализации интерфейса

IDataRecord.GetData(Int32)

Описание этого элемента см. в разделе GetData(Int32). (Унаследовано от DbDataReader)

Методы расширения

CanGetColumnSchema(DbDataReader)	Возвращает значение, указывающее, может ли DbDataReader получить схему столбца.
GetColumnSchema(DbDataReader)	Получает схему столбцов (коллекциюDbColumn) для DbDataReader.
GetBoolean(DbDataReader, String)	Возвращает значение указанного столбца как логическое значение.
GetByte(DbDataReader, String)	Возвращает значение указанного столбца в виде байта.
GetBytes(DbDataReader, String, Int64, Byte[], Int32, Int32)	Считывает указанное число байтов из указанного столбца, начиная с указанного индекса, и записывает их в буфер, начиная с указанной позиции в буфере.
GetChar(DbDataReader, String)	Возвращает значение указанного столбца в виде одного символа.
GetChars(DbDataReader, String, Int64, Char[], Int32, Int32)	Считывает указанное число символов из указанного столбца, начиная с указанного индекса, и записывает их в буфер, начиная с указанной позиции.
GetData(DbDataReader, String)	Возвращает вложенное средство чтения данных для запрошенного столбца.
GetDataTypeName(DbDataReader, String)	Возвращает имя типа данных указанного столбца.
GetDateTime(DbDataReader, String)	Возвращает значение указанного столбца в качестве объекта DateTime.
GetDecimal(DbDataReader, String)	Возвращает значение указанного столбца в виде Decimal.
GetDouble(DbDataReader, String)	Возвращает значение указанного столбца в виде числа с плавающей запятой двойной точности.
GetFieldType(DbDataReader, String)	Возвращает тип данных указанного столбца.
GetFieldValue<T>(DbDataReader, String)	Возвращает значение указанного столбца в качестве запрошенного типа.
GetFieldValueAsync<T>(DbDataReader, String, CancellationToken)	Асинхронно получает значение указанного столбца в качестве запрошенного типа.
GetFloat(DbDataReader, String)	Возвращает значение указанного столбца в виде числа с плавающей запятой с одной точностью.
GetGuid(DbDataReader, String)	Возвращает значение указанного столбца в качестве глобально уникального идентификатора (GUID).
GetInt16(DbDataReader, String)	Возвращает значение указанного столбца в виде 16-разрядного целого числа со знаком.
GetInt32(DbDataReader, String)	Возвращает значение указанного столбца в виде 32-разрядного целого числа со знаком.
GetInt64(DbDataReader, String)	Возвращает значение указанного столбца в виде 64-разрядного целого числа со знаком.
GetProviderSpecificFieldType(DbDataReader, String)	Возвращает тип конкретного поставщика указанного столбца.
GetProviderSpecificValue(DbDataReader, String)	Возвращает значение указанного столбца в качестве экземпляра конкретного типа поставщика.
GetStream(DbDataReader, String)	Получает поток для получения данных из указанного столбца.
GetString(DbDataReader, String)	Возвращает значение указанного столбца в качестве экземпляра String.
GetTextReader(DbDataReader, String)	Получает средство чтения текста для получения данных из столбца.
GetValue(DbDataReader, String)	Возвращает значение указанного столбца в качестве экземпляра Object.
IsDBNull(DbDataReader, String)	Возвращает значение, указывающее, содержит ли столбец несуществующие или отсутствующие значения.
IsDBNullAsync(DbDataReader, String, CancellationToken)	Асинхронно получает значение, указывающее, содержит ли столбец отсутствующие или отсутствующие значения.
Cast<TResult>(IEnumerable)	Приведение элементов IEnumerable к указанному типу.
OfType<TResult>(IEnumerable)	Фильтрует элементы IEnumerable на основе указанного типа.
AsParallel(IEnumerable)	Включает параллелизацию запроса.
AsQueryable(IEnumerable)	Преобразует IEnumerable в IQueryable.
ConfigureAwait(IAsyncDisposable, Boolean)	Настраивает способ ожидания задач, возвращаемых из асинхронного удаления.

Применяется к