DataTableReader Класс

Определение

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

System.Data

Сборка:

System.Data.dll

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

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

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

Object

MarshalByRefObject

DbDataReader

DataTableReader

Комментарии

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

При создании DataTableReaderDataTableобъекта из результирующего 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.
CreateObjRef(Type)	Создает объект, содержащий все соответствующие сведения, необходимые для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject)
Dispose()	Освобождает все ресурсы, используемые текущим экземпляром класса DbDataReader. (Унаследовано от DbDataReader)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые DbDataReader и при необходимости освобождает управляемые ресурсы. (Унаследовано от DbDataReader)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetBoolean(Int32)	Возвращает значение указанного столбца в виде Boolean.
GetByte(Int32)	Возвращает значение указанного столбца в виде байта.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Считывает поток байтов, начиная с смещения указанного столбца, в буфер в виде массива, начиная с указанного смещения буфера.
GetChar(Int32)	Возвращает значение указанного столбца в виде символа.
GetChars(Int32, Int64, Char[], Int32, Int32)	Возвращает значение указанного столбца в виде массива символов.
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.
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)

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

Имя	Описание
AsParallel(IEnumerable)	Включает параллелизацию запроса.
AsQueryable(IEnumerable)	Преобразует IEnumerable в IQueryable.
CanGetColumnSchema(DbDataReader)	Возвращает значение, указывающее, может ли получить DbDataReader схему столбца.
Cast<TResult>(IEnumerable)	Приведение элементов IEnumerable к указанному типу.
GetColumnSchema(DbDataReader)	Возвращает схему столбца (DbColumnколлекцию) для .DbDataReader
OfType<TResult>(IEnumerable)	Фильтрует элементы IEnumerable на основе указанного типа.