EntityDataReader Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Считывает поток строк, доступных только для пересылки, из источника данных.
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
- Наследование
- Реализации
Комментарии
Объединяет функциональные возможности DbDataReader класса и IExtendedDataRecord интерфейса.
У EntityDataReader него нет общедоступного конструктора. Его можно получить только через одну из EntityCommand.ExecuteReader перегрузок метода.
SQL Server помещает выходные параметры из хранимых процедур в конец потока результатов после всех результирующих наборов. Таким образом, чтобы получить значения выходных параметров, приложение должно использовать все записи во всех результирующих наборах. Если приложение закрывает (которое также закроет EntityDataReaderDbDataReader), выходные параметры могут не заполняться.
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 Закрывает объект. |
| CreateObjRef(Type) |
Создает объект, содержащий все соответствующие сведения, необходимые для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject) |
| Dispose() |
Освобождает все ресурсы, используемые текущим экземпляром класса DbDataReader. (Унаследовано от DbDataReader) |
| Dispose(Boolean) |
Освобождает ресурсы, потребляемые этим EntityDataReader и вызовами Close(). |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetBoolean(Int32) |
Возвращает значение указанного столбца как логическое значение. |
| GetByte(Int32) |
Возвращает значение указанного столбца в виде байта. |
| GetBytes(Int32, Int64, Byte[], Int32, Int32) |
Считывает поток байтов из указанного столбца, начиная с расположения, указанного |
| GetChar(Int32) |
Возвращает значение указанного столбца в виде одного символа. |
| GetChars(Int32, Int64, Char[], Int32, Int32) |
Считывает поток символов из указанного столбца, начиная с расположения, указанного |
| 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, 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) |
Возвращает имя столбца, учитывая порядковый номер столбца от нуля. |
| GetOrdinal(String) |
Получает порядковый номер столбца, заданный именем столбца. |
| GetProviderSpecificFieldType(Int32) |
Возвращает тип поля для конкретного поставщика указанного столбца. |
| GetProviderSpecificValue(Int32) |
Возвращает значение указанного столбца в качестве экземпляра Object. |
| GetProviderSpecificValues(Object[]) |
Возвращает все столбцы атрибутов для конкретного поставщика в коллекции для текущей строки. |
| GetSchemaTable() |
Возвращает значение DataTable , описывающее метаданные столбца DbDataReader. |
| GetStream(Int32) |
Получает поток для получения данных из указанного столбца. (Унаследовано от DbDataReader) |
| GetString(Int32) |
Возвращает значение указанного столбца в качестве экземпляра String. |
| GetTextReader(Int32) |
Получает средство чтения текста для получения данных из столбца. (Унаследовано от DbDataReader) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| GetValue(Int32) |
Возвращает значение указанного столбца в качестве экземпляра Object. |
| GetValues(Object[]) |
Заполняет массив объектов значениями столбцов текущей строки. |
| InitializeLifetimeService() |
Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject) |
| IsDBNull(Int32) |
Возвращает значение, указывающее, содержит ли столбец несуществующие или отсутствующие значения. |
| IsDBNullAsync(Int32, CancellationToken) |
Асинхронно получает значение, указывающее, содержит ли столбец отсутствующие или отсутствующие значения. (Унаследовано от DbDataReader) |
| IsDBNullAsync(Int32) |
Асинхронно получает значение, указывающее, содержит ли столбец отсутствующие или отсутствующие значения. (Унаследовано от 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) |
Методы расширения
| Имя | Описание |
|---|---|
| AsParallel(IEnumerable) |
Включает параллелизацию запроса. |
| AsQueryable(IEnumerable) |
Преобразует IEnumerable в IQueryable. |
| CanGetColumnSchema(DbDataReader) |
Возвращает значение, указывающее, может ли получить DbDataReader схему столбца. |
| Cast<TResult>(IEnumerable) |
Приведение элементов IEnumerable к указанному типу. |
| GetColumnSchema(DbDataReader) |
Возвращает схему столбца (DbColumnколлекцию) для .DbDataReader |
| OfType<TResult>(IEnumerable) |
Фильтрует элементы IEnumerable на основе указанного типа. |