DataTableReader DataTableReader DataTableReader DataTableReader Class

Определение

Объект DataTableReader получает содержимое одного или нескольких объектов DataTable в виде одного или нескольких однопроходных результирующих наборов, доступных только для чтения.The DataTableReader obtains the contents of one or more DataTable objects in the form of one or more read-only, forward-only result sets.

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.The DataTableReader works much like any other data reader, such as the SqlDataReader, except that the DataTableReader provides for iterating over rows in a DataTable. Другими словами он обеспечивает итерацию строк в кэше.In other words, it provides for iterating over rows in a cache. Кэшированные данные могут быть изменены во время DataTableReader активен, и чтения автоматически сохраняет свое положение.The cached data can be modified while the DataTableReader is active, and the reader automatically maintains its position.

При создании DataTableReader из DataTable, полученный в результате DataTableReader объект содержит один результирующий набор с теми же данными, как DataTable из которого он был создан, за исключением любых строк, которые были помечены как удаленные.When you create a DataTableReader from a DataTable, the resulting DataTableReader object contains one result set with the same data as the DataTable from which it was created, except for any rows that have been marked as deleted. Столбцы отображаются в том же порядке, как и в исходном DataTable.The columns appear in the same order as in the original DataTable. Структура возвращенный результат в схему и данные совпадают с исходными DataTable.The structure of the returned result is identical in schema and data to the original DataTable. Объект DataTableReader , созданный путем вызова метода CreateDataReader метод DataSet объект содержит несколько результирующих наборов, если DataSet содержит более одной таблицы.A DataTableReader that was created by calling the CreateDataReader method of a DataSet object contains multiple result sets if the DataSet contains more than one table. Результаты отображаются в той же последовательности, что DataTable объекты в DataTableCollection из DataSet объекта.The results are in the same sequence as the DataTable objects in the DataTableCollection of the DataSet object.

Возвращаемый результирующий набор содержит только текущую версию каждого DataRow; пропускаются строки, помеченные для удаления.The returned result set contains only the current version of each DataRow; rows that are marked for deletion are skipped.

DataTableReader Предоставляет стабильного итератора, то есть содержимое DataTableReader остаются действительными, если размер базовой коллекции изменяется во время итерации.The DataTableReader provides a stable iterator; that is, the contents of the DataTableReader are not invalidated if the size of the underlying collection is modified during iteration. Например, если один или более строк в Rows удаляются или удаляется в ходе итерации, текущую позицию в коллекции DataTableReader соответствующим образом изменяется и не делает недействительными итератора.For example, if one or more rows in the Rows collection are deleted or removed during iteration, the current position within the DataTableReader is maintained appropriately and it does not invalidate the iterator.

Конструкторы

DataTableReader(DataTable) DataTableReader(DataTable) DataTableReader(DataTable) DataTableReader(DataTable)

Инициализирует новый экземпляр класса DataTableReader, с использованием данных из заданного объекта DataTable.Initializes a new instance of the DataTableReader class by using data from the supplied DataTable.

DataTableReader(DataTable[]) DataTableReader(DataTable[]) DataTableReader(DataTable[]) DataTableReader(DataTable[])

Инициализирует новый экземпляр класса DataTableReader, используя указанный массив объектов DataTable.Initializes a new instance of the DataTableReader class using the supplied array of DataTable objects.

Свойства

Depth Depth Depth Depth

Глубина вложенности для текущей строки объекта DataTableReader.The depth of nesting for the current row of the DataTableReader.

FieldCount FieldCount FieldCount FieldCount

Возвращает количество столбцов в текущей строке.Returns the number of columns in the current row.

HasRows HasRows HasRows HasRows

Получает значение, указывающее, содержит ли объект DataTableReader одну или несколько строк.Gets a value that indicates whether the DataTableReader contains one or more rows.

IsClosed IsClosed IsClosed IsClosed

Получает значение, указывающее, закрыт ли объект DataTableReader.Gets a value that indicates whether the DataTableReader is closed.

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Возвращает значение указанного столбца в собственном формате при наличии заданного порядкового номера столбца.Gets the value of the specified column in its native format given the column ordinal.

Item[String] Item[String] Item[String] Item[String]

Возвращает значение заданного столбца в собственном формате при наличии заданного имени столбца.Gets the value of the specified column in its native format given the column name.

RecordsAffected RecordsAffected RecordsAffected RecordsAffected

Получает количество строк, которые были изменены, вставлены или удалены при выполнении оператора SQL.Gets the number of rows inserted, changed, or deleted by execution of the SQL statement.

VisibleFieldCount VisibleFieldCount VisibleFieldCount VisibleFieldCount

Возвращает число не скрытых полей в DbDataReader.Gets the number of fields in the DbDataReader that are not hidden.

(Inherited from DbDataReader)

Методы

Close() Close() Close() Close()

Закрывает текущий объект DataTableReader.Closes the current DataTableReader.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Освобождает все ресурсы, используемые текущим экземпляром класса DbDataReader.Releases all resources used by the current instance of the DbDataReader class.

(Inherited from DbDataReader)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Освобождает управляемые ресурсы, используемые объектом DbDataReader (при необходимости освобождает и неуправляемые ресурсы).Releases the managed resources used by the DbDataReader and optionally releases the unmanaged resources.

(Inherited from DbDataReader)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetBoolean(Int32) GetBoolean(Int32) GetBoolean(Int32) GetBoolean(Int32)

Возвращает значение заданного столбца в виде объекта Boolean.Gets the value of the specified column as a Boolean.

GetByte(Int32) GetByte(Int32) GetByte(Int32) GetByte(Int32)

Возвращает значение указанного столбца в виде байта.Gets the value of the specified column as a byte.

GetBytes(Int32, Int64, Byte[], Int32, Int32) GetBytes(Int32, Int64, Byte[], Int32, Int32) GetBytes(Int32, Int64, Byte[], Int32, Int32) GetBytes(Int32, Int64, Byte[], Int32, Int32)

Считывает поток байтов с заданного смещения столбца в буфер в виде массива, который начинается с конкретного смещения буфера.Reads a stream of bytes starting at the specified column offset into the buffer as an array starting at the specified buffer offset.

GetChar(Int32) GetChar(Int32) GetChar(Int32) GetChar(Int32)

Возвращает значение указанного столбца в виде символа.Gets the value of the specified column as a character.

GetChars(Int32, Int64, Char[], Int32, Int32) GetChars(Int32, Int64, Char[], Int32, Int32) GetChars(Int32, Int64, Char[], Int32, Int32) GetChars(Int32, Int64, Char[], Int32, Int32)

Возвращает значение указанного столбца в виде массива символов.Returns the value of the specified column as a character array.

GetData(Int32) GetData(Int32) GetData(Int32) GetData(Int32)

Возвращает объект DbDataReader для запрошенного порядкового номера столбца.Returns a DbDataReader object for the requested column ordinal.

(Inherited from DbDataReader)
GetDataTypeName(Int32) GetDataTypeName(Int32) GetDataTypeName(Int32) GetDataTypeName(Int32)

Получает строку, представляющую тип данных в указанном столбце.Gets a string representing the data type of the specified column.

GetDateTime(Int32) GetDateTime(Int32) GetDateTime(Int32) GetDateTime(Int32)

Возвращает значение указанного столбца в виде объекта DateTime.Gets the value of the specified column as a DateTime object.

GetDbDataReader(Int32) GetDbDataReader(Int32) GetDbDataReader(Int32) GetDbDataReader(Int32)

Возвращает объект DbDataReader для запрошенного порядкового номера столбца, который можно переопределить реализацией, зависящей от поставщика.Returns a DbDataReader object for the requested column ordinal that can be overridden with a provider-specific implementation.

(Inherited from DbDataReader)
GetDecimal(Int32) GetDecimal(Int32) GetDecimal(Int32) GetDecimal(Int32)

Возвращает значение заданного столбца в виде объекта Decimal.Gets the value of the specified column as a Decimal.

GetDouble(Int32) GetDouble(Int32) GetDouble(Int32) GetDouble(Int32)

Возвращает значение указанного столбца в виде числа с плавающей запятой с двойной точностью.Gets the value of the column as a double-precision floating point number.

GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Возвращает перечислитель, который может использоваться для перемещения по коллекции элементов.Returns an enumerator that can be used to iterate through the item collection.

GetFieldType(Int32) GetFieldType(Int32) GetFieldType(Int32) GetFieldType(Int32)

Возвращает тип Type, который является типом данных объекта.Gets the Type that is the data type of the object.

GetFieldValue<T>(Int32) GetFieldValue<T>(Int32) GetFieldValue<T>(Int32) GetFieldValue<T>(Int32)

Синхронно получает значение заданного столбца в виде типа.Synchronously gets the value of the specified column as a type.

(Inherited from DbDataReader)
GetFieldValueAsync<T>(Int32) GetFieldValueAsync<T>(Int32) GetFieldValueAsync<T>(Int32) GetFieldValueAsync<T>(Int32)

Асинхронно получает значение заданного столбца в виде типа.Asynchronously gets the value of the specified column as a type.

(Inherited from DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken) GetFieldValueAsync<T>(Int32, CancellationToken) GetFieldValueAsync<T>(Int32, CancellationToken) GetFieldValueAsync<T>(Int32, CancellationToken)

Асинхронно получает значение заданного столбца в виде типа.Asynchronously gets the value of the specified column as a type.

(Inherited from DbDataReader)
GetFloat(Int32) GetFloat(Int32) GetFloat(Int32) GetFloat(Int32)

Возвращает значение заданного столбца в виде числа с плавающей запятой одинарной точности.Gets the value of the specified column as a single-precision floating point number.

GetGuid(Int32) GetGuid(Int32) GetGuid(Int32) GetGuid(Int32)

Возвращает значение заданного столбца в виде глобально-уникального идентификатора GUID.Gets the value of the specified column as a globally-unique identifier (GUID).

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetInt16(Int32) GetInt16(Int32) GetInt16(Int32) GetInt16(Int32)

Получает значение заданного столбца в виде 16-битового целого числа со знаком.Gets the value of the specified column as a 16-bit signed integer.

GetInt32(Int32) GetInt32(Int32) GetInt32(Int32) GetInt32(Int32)

Возвращает значение указанного столбца в виде 32-разрядного целого числа со знаком.Gets the value of the specified column as a 32-bit signed integer.

GetInt64(Int32) GetInt64(Int32) GetInt64(Int32) GetInt64(Int32)

Возвращает значение указанного столбца в виде 64-разрядного целого числа со знаком.Gets the value of the specified column as a 64-bit signed integer.

GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetName(Int32) GetName(Int32) GetName(Int32) GetName(Int32)

Возвращает значение заданного столбца в виде объекта String.Gets the value of the specified column as a String.

GetOrdinal(String) GetOrdinal(String) GetOrdinal(String) GetOrdinal(String)

Возвращает порядковый номер столбца при наличии заданного имени столбца.Gets the column ordinal, given the name of the column.

GetProviderSpecificFieldType(Int32) GetProviderSpecificFieldType(Int32) GetProviderSpecificFieldType(Int32) GetProviderSpecificFieldType(Int32)

Возвращает тип указанного столбца в формате конкретного поставщика.Gets the type of the specified column in provider-specific format.

GetProviderSpecificValue(Int32) GetProviderSpecificValue(Int32) GetProviderSpecificValue(Int32) GetProviderSpecificValue(Int32)

Возвращает значение указанного столбца в формате конкретного поставщика.Gets the value of the specified column in provider-specific format.

GetProviderSpecificValues(Object[]) GetProviderSpecificValues(Object[]) GetProviderSpecificValues(Object[]) GetProviderSpecificValues(Object[])

Заполняет предоставленный массив данными с типом конкретного поставщика для всех столбцов в объекте DataTableReader.Fills the supplied array with provider-specific type information for all the columns in the DataTableReader.

GetSchemaTable() GetSchemaTable() GetSchemaTable() GetSchemaTable()

Возвращает объект DataTable, описывающий метаданные столбцов модуля чтения данных DataTableReader.Returns a DataTable that describes the column metadata of the DataTableReader.

GetStream(Int32) GetStream(Int32) GetStream(Int32) GetStream(Int32)

Извлекает данные в виде Stream.Retrieves data as a Stream.

(Inherited from DbDataReader)
GetString(Int32) GetString(Int32) GetString(Int32) GetString(Int32)

Возвращает значение заданного столбца в виде строки.Gets the value of the specified column as a string.

GetTextReader(Int32) GetTextReader(Int32) GetTextReader(Int32) GetTextReader(Int32)

Извлекает данные в виде TextReader.Retrieves data as a TextReader.

(Inherited from DbDataReader)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
GetValue(Int32) GetValue(Int32) GetValue(Int32) GetValue(Int32)

Возвращает значение заданного столбца в его исходном формате.Gets the value of the specified column in its native format.

GetValues(Object[]) GetValues(Object[]) GetValues(Object[]) GetValues(Object[])

Заполняет массив объектов значениями столбцов текущей строки.Populates an array of objects with the column values of the current row.

InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
IsDBNull(Int32) IsDBNull(Int32) IsDBNull(Int32) IsDBNull(Int32)

Получает значение, указывающее, содержит ли столбец несуществующие или пропущенные значения.Gets a value that indicates whether the column contains non-existent or missing values.

IsDBNullAsync(Int32) IsDBNullAsync(Int32) IsDBNullAsync(Int32) IsDBNullAsync(Int32)

Асинхронная версия метода IsDBNull(Int32), который получает значение, указывающее, содержит ли столбец несуществующие или отсутствующие значения.An asynchronous version of IsDBNull(Int32), which gets a value that indicates whether the column contains non-existent or missing values.

(Inherited from DbDataReader)
IsDBNullAsync(Int32, CancellationToken) IsDBNullAsync(Int32, CancellationToken) IsDBNullAsync(Int32, CancellationToken) IsDBNullAsync(Int32, CancellationToken)

Асинхронная версия метода IsDBNull(Int32), который получает значение, указывающее, содержит ли столбец несуществующие или отсутствующие значения.An asynchronous version of IsDBNull(Int32), which gets a value that indicates whether the column contains non-existent or missing values. При необходимости отправляет уведомление о том, что операции следует отменить.Optionally, sends a notification that operations should be cancelled.

(Inherited from DbDataReader)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Создает неполную копию текущего объекта MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
NextResult() NextResult() NextResult() NextResult()

Перемещает DataTableReader к следующему результирующему набору (при его наличии).Advances the DataTableReader to the next result set, if any.

NextResultAsync() NextResultAsync() NextResultAsync() NextResultAsync()

Асинхронная версия метода NextResult(), который перемещает средство чтения к следующему результату при чтении результатов из пакета инструкций.An asynchronous version of NextResult(), which advances the reader to the next result when reading the results of a batch of statements.

Вызывает NextResultAsync(CancellationToken) с CancellationToken.None.Invokes NextResultAsync(CancellationToken) with CancellationToken.None.

(Inherited from DbDataReader)
NextResultAsync(CancellationToken) NextResultAsync(CancellationToken) NextResultAsync(CancellationToken) NextResultAsync(CancellationToken)

Это асинхронная версия метода NextResult().This is the asynchronous version of NextResult(). Поставщики должны выполнить переопределение с помощью соответствующей реализации.Providers should override with an appropriate implementation. При необходимости можно игнорировать cancellationToken.The cancellationToken may optionally be ignored.

Реализация по умолчанию вызывает синхронный метод NextResult() и возвращает завершенную задачу, блокируя вызывающий поток.The default implementation invokes the synchronous NextResult() method and returns a completed task, blocking the calling thread. Реализация по умолчанию возвращает отмененную задачу, если ей передается уже отмененный cancellationToken.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Исключения, создаваемые NextResult(), будут связаны через возвращаемое свойство исключения задачи.Exceptions thrown by NextResult() will be communicated via the returned Task Exception property.

Другие методы и свойства объекта DbDataReader не должны вызываться, когда возвращаемая задача еще не завершена.Other methods and properties of the DbDataReader object should not be invoked while the returned Task is not yet completed.

(Inherited from DbDataReader)
Read() Read() Read() Read()

Перемещает DataTableReader к следующей записи.Advances the DataTableReader to the next record.

ReadAsync() ReadAsync() ReadAsync() ReadAsync()

Асинхронная версия Read(), которая перемещает модуль чтения к следующей записи в наборе результатов.An asynchronous version of Read(), which advances the reader to the next record in a result set. Этот метод вызывает метод ReadAsync(CancellationToken) с CancellationToken.None.This method invokes ReadAsync(CancellationToken) with CancellationToken.None.

(Inherited from DbDataReader)
ReadAsync(CancellationToken) ReadAsync(CancellationToken) ReadAsync(CancellationToken) ReadAsync(CancellationToken)

Это асинхронная версия метода Read().This is the asynchronous version of Read(). Поставщики должны выполнить переопределение с помощью соответствующей реализации.Providers should override with an appropriate implementation. При необходимости можно игнорировать cancellationToken.The cancellationToken may optionally be ignored.

Реализация по умолчанию вызывает синхронный метод Read() и возвращает завершенную задачу, блокируя вызывающий поток.The default implementation invokes the synchronous Read() method and returns a completed task, blocking the calling thread. Реализация по умолчанию возвращает отмененную задачу, если ей передается уже отмененный cancellationToken.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Исключения, создаваемые Read, будут связаны через возвращаемое свойство исключения задачи.Exceptions thrown by Read will be communicated via the returned Task Exception property.

Не вызывайте другие методы и свойства объекта DbDataReader до тех пор, пока возвращаемая задача не будет завершена.Do not invoke other methods and properties of the DbDataReader object until the returned Task is complete.

(Inherited from DbDataReader)
ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

Явные реализации интерфейса

IDataReader.Close() IDataReader.Close() IDataReader.Close() IDataReader.Close() Inherited from DbDataReader
IDataReader.GetSchemaTable() IDataReader.GetSchemaTable() IDataReader.GetSchemaTable() IDataReader.GetSchemaTable() Inherited from DbDataReader
IDataRecord.GetData(Int32) IDataRecord.GetData(Int32) IDataRecord.GetData(Int32) IDataRecord.GetData(Int32)

Описание этого члена см. в разделе GetData(Int32).For a description of this member, see GetData(Int32).

(Inherited from DbDataReader)

Extension Methods

CanGetColumnSchema(DbDataReader) CanGetColumnSchema(DbDataReader) CanGetColumnSchema(DbDataReader) CanGetColumnSchema(DbDataReader)

Получает значение, которое указывает, может ли DbDataReader получить схему столбца.Gets a value that indicates whether a DbDataReader can get a column schema.

GetColumnSchema(DbDataReader) GetColumnSchema(DbDataReader) GetColumnSchema(DbDataReader) GetColumnSchema(DbDataReader)

Получает схему столбца (коллекцию DbColumn) для DbDataReader.Gets the column schema (DbColumn collection) for a DbDataReader.

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Приводит элементы объекта IEnumerable к заданному типу.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Выполняет фильтрацию элементов объекта IEnumerable по заданному типу.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Позволяет осуществлять параллельный запрос.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Преобразовывает коллекцию IEnumerable в объект IQueryable.Converts an IEnumerable to an IQueryable.

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