DataTableReader Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
DataTableReader получает содержимое одного или нескольких объектов DataTable в виде одного или нескольких наборов результатов только для чтения.
public ref class DataTableReader sealed : System::Data::Common::DbDataReaderpublic sealed class DataTableReader : System.Data.Common.DbDataReadertype DataTableReader = class
inherit DbDataReaderPublic 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, 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().
Поставщики должны переопределить соответствующую реализацию.
|
| 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) |
Настраивает способ ожидания задач, возвращаемых из асинхронного удаления. |
