DataTableReader Класс

Ссылка

Определение

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

Сборка:: System.Data.Common.dll

Сборка:: System.Data.dll

Сборка:: netstandard.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 активности, и средство чтения автоматически сохраняет свое положение.

При создании объекта 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)
CreateObjRef(Type)	Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject)
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)	Асинхронно возвращает значение указанного столбца в виде запрошенного типа. (Унаследовано от DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)	Асинхронно возвращает значение указанного столбца в виде запрошенного типа. (Унаследовано от 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)	Асинхронно получает значение, указывающее, содержит ли столбец несуществующие или пропущенные значения. (Унаследовано от DbDataReader)
IsDBNullAsync(Int32, CancellationToken)	Асинхронно получает значение, указывающее, содержит ли столбец несуществующие или пропущенные значения. (Унаследовано от 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)	Настраивает способ выполнения ожиданий для задач, возвращаемых из асинхронного высвобождаемого объекта.

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