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) |
Настраивает способ ожидания задач, возвращаемых из асинхронного удаления. |