EntityDataReader Класс

Ссылка

Определение

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

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

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Считывает однопроходные потоки строк из источника данных.

public ref class EntityDataReader : System::Data::Common::DbDataReader, System::Data::IExtendedDataRecord

public class EntityDataReader : System.Data.Common.DbDataReader, System.Data.IExtendedDataRecord

type EntityDataReader = class
    inherit DbDataReader
    interface IExtendedDataRecord
    interface IDataRecord

Public Class EntityDataReader
Inherits DbDataReader
Implements IExtendedDataRecord

Наследование: Object

MarshalByRefObject

DbDataReader
EntityDataReader

Реализации: IDataRecord IExtendedDataRecord

SQL Server помещает выходные параметры хранимых процедур в конец потока результатов после всех результирующих наборов. Поэтому для получения значений выходных параметров приложение должно использовать все записи во всех результирующих наборах. Если приложение закрывает EntityDataReader (что также закрывает DbDataReader), выходные параметры могут не заполняться.

EntityDataReader не использует неявно результирующие наборы, чтобы сделать доступными выходные параметры. Поэтому обратите внимание на следующее:

EntityDataReader вызывает только при DbDataReader.NextResult EntityDataReader.NextResult явном вызове . Если DbDataReader.NextResult вызывает исключение, объект EntityDataReader заключит его в EntityException (или производное исключение).
Close закрывает DbDataReaderтолько объект , не используя ожидающие записи или результирующие наборы.
Dispose удаляет DbDataReaderтолько объект , не используя ожидающие записи или результирующие наборы.

Примеры кода см. в разделе Работа с EntityClient.

Свойства

DataRecordInfo	Возвращает DataRecordInfo для этой транзакции IExtendedDataRecord.
Depth	Возвращает значение, показывающее глубину вложенности для текущей строки.
FieldCount	Возвращает число столбцов в текущей строке.
HasRows	Возвращает значение, указывающее на то, что в модуле чтения данных EntityDataReader содержится одна или несколько строк.
IsClosed	Возвращает значение, указывающее, закрыт ли модуль чтения EntityDataReader.
Item[Int32]	Возвращает значение указанного столбца как экземпляр Object.
Item[String]	Возвращает значение указанного столбца как экземпляр Object.
RecordsAffected	Возвращает число строк, которые были изменены, вставлены или удалены инструкцией SQL.
VisibleFieldCount	Возвращает число не скрытых полей в EntityDataReader.

Методы

Close()	Закрывает объект EntityDataReader.
CloseAsync()	Асинхронно закрывает объект DbDataReader. (Унаследовано от DbDataReader)
CreateObjRef(Type)	Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject)
Dispose()	Освобождает все ресурсы, используемые текущим экземпляром класса DbDataReader. (Унаследовано от DbDataReader)
Dispose(Boolean)	Освобождает ресурсы, используемые этим модулем EntityDataReader, и вызывает метод Close().
DisposeAsync()	Асинхронно освобождает все ресурсы, используемые текущим экземпляром класса DbDataReader. (Унаследовано от DbDataReader)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetBoolean(Int32)	Возвращает значение указанного столбца в виде логического значения.
GetByte(Int32)	Возвращает значение указанного столбца в виде байта.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Считывает поток байтов из указанного столбца, начиная с местоположения, указанного параметром `dataIndex`, в буфер, начиная с местоположения, указанного параметром `bufferIndex`.
GetChar(Int32)	Возвращает значение указанного столбца в виде одного символа.
GetChars(Int32, Int64, Char[], Int32, Int32)	Считывает поток символов из указанного столбца, начиная с местоположения, указанного параметром `dataIndex`, в буфер, начиная с местоположения, указанного параметром `bufferIndex`.
GetColumnSchemaAsync(CancellationToken)	Это асинхронная версия метода GetColumnSchema(DbDataReader). Поставщики должны выполнить переопределение с помощью соответствующей реализации. При необходимости можно учитывать `cancellationToken`. Реализация по умолчанию вызывает синхронный метод GetColumnSchema(DbDataReader) и возвращает выполненную задачу. Реализация по умолчанию возвращает отмененную задачу, если ей передается уже отмененный `cancellationToken`. Исключения, создаваемые GetColumnSchema(DbDataReader), будут связаны через возвращаемое свойство исключения задачи. (Унаследовано от DbDataReader)
GetData(Int32)	Возвращает вложенный объект чтения данных для запрошенного столбца. (Унаследовано от DbDataReader)
GetDataReader(Int32)	Возвращает вложенные модули чтения данных в виде объектов DbDataReader.
GetDataRecord(Int32)	Возвращает вложенную запись DbDataRecord.
GetDataTypeName(Int32)	Получает имя типа данных указанного столбца.
GetDateTime(Int32)	Возвращает значение указанного столбца в виде объекта DateTime.
GetDbDataReader(Int32)	Возвращает объект DbDataReader для запрошенного порядкового номера столбца, который может быть переопределен с помощью зависящей от поставщика реализации.
GetDecimal(Int32)	Возвращает значение указанного столбца в виде объекта Decimal.
GetDouble(Int32)	Возвращает значение указанного столбца в виде числа с плавающей запятой двойной точности.
GetEnumerator()	Возвращает перечислитель IEnumerator, который может использоваться для просмотра строк в модуле чтения данных.
GetFieldType(Int32)	Возвращает тип данных заданного столбца.
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)	Возвращает имя столбца, если известен его порядковый номер (от нуля).
GetOrdinal(String)	Возвращает порядковый номер столбца, если известно его имя.
GetProviderSpecificFieldType(Int32)	Возвращает тип поля заданного столбца, зависящий от поставщика.
GetProviderSpecificValue(Int32)	Возвращает значение указанного столбца как экземпляр Object.
GetProviderSpecificValues(Object[])	Возвращает из коллекции все столбцы атрибутов, зависящие от поставщика, для текущей строки.
GetSchemaTable()	Возвращает объект DataTable, описывающий метаданные столбцов модуля чтения данных DbDataReader.
GetSchemaTableAsync(CancellationToken)	Это асинхронная версия метода GetSchemaTable(). Поставщики должны выполнить переопределение с помощью соответствующей реализации. При необходимости можно учитывать `cancellationToken`. Реализация по умолчанию вызывает синхронный метод GetSchemaTable() и возвращает выполненную задачу. Реализация по умолчанию возвращает отмененную задачу, если ей передается уже отмененный `cancellationToken`. Исключения, создаваемые GetSchemaTable(), будут связаны через возвращаемое свойство исключения задачи. (Унаследовано от DbDataReader)
GetStream(Int32)	Возвращает поток для получения данных из указанного столбца. (Унаследовано от DbDataReader)
GetString(Int32)	Возвращает значение указанного столбца как экземпляр String.
GetTextReader(Int32)	Получает модуль чтения текста для извлечения данных из столбца. (Унаследовано от DbDataReader)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
GetValue(Int32)	Возвращает значение указанного столбца как экземпляр Object.
GetValues(Object[])	Заполняет массив объектов значениями столбцов текущей строки.
InitializeLifetimeService()	Устаревшие.. Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
IsDBNull(Int32)	Возвращает значение, указывающее, содержатся ли в столбце несуществующие или отсутствующие значения.
IsDBNullAsync(Int32)	Асинхронно получает значение, указывающее, содержит ли столбец несуществующие или пропущенные значения. (Унаследовано от DbDataReader)
IsDBNullAsync(Int32, CancellationToken)	Асинхронно получает значение, указывающее, содержит ли столбец несуществующие или пропущенные значения. (Унаследовано от DbDataReader)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
MemberwiseClone(Boolean)	Создает неполную копию текущего объекта MarshalByRefObject. (Унаследовано от MarshalByRefObject)
NextResult()	Перемещает модуль чтения данных к следующему результату при чтении результатов из пакета инструкций.
NextResultAsync()	Асинхронно перемещает модуль чтения данных к следующему результату при чтении результатов из пакета инструкций. (Унаследовано от DbDataReader)
NextResultAsync(CancellationToken)	Асинхронно перемещает модуль чтения данных к следующему результату при чтении результатов из пакета инструкций. (Унаследовано от DbDataReader)
Read()	Перемещает модуль чтения к следующей записи в результирующем наборе.
ReadAsync()	Асинхронно перемещает модуль чтения к следующей записи в результирующем наборе. (Унаследовано от DbDataReader)
ReadAsync(CancellationToken)	Асинхронно перемещает модуль чтения к следующей записи в результирующем наборе. (Унаследовано от DbDataReader)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

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

IDataRecord.GetData(Int32)

Описание этого члена см. в разделе GetData(Int32).

(Унаследовано от DbDataReader)

Методы расширения

CanGetColumnSchema(DbDataReader)	Получает значение, которое указывает, может ли DbDataReader получить схему столбца.
GetColumnSchema(DbDataReader)	Получает схему столбца (коллекцию DbColumn) для DbDataReader.
Cast<TResult>(IEnumerable)	Приводит элементы объекта IEnumerable к заданному типу.
OfType<TResult>(IEnumerable)	Выполняет фильтрацию элементов объекта IEnumerable по заданному типу.
AsParallel(IEnumerable)	Позволяет осуществлять параллельный запрос.
AsQueryable(IEnumerable)	Преобразовывает коллекцию IEnumerable в объект IQueryable.

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