DataTableReader Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Объект 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
- Наследование
Комментарии
Это 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).
Поставщики должны выполнить переопределение с помощью соответствующей реализации.
При необходимости можно учитывать |
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().
Поставщики должны выполнить переопределение с помощью соответствующей реализации.
При необходимости можно учитывать |
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) |
Настраивает способ выполнения ожиданий для задач, возвращаемых из асинхронного высвобождаемого объекта. |