EntityDataReader Clase

Definición

Espacio de nombres:

System.Data.EntityClient

Ensamblado:

System.Data.Entity.dll

Lee una secuencia de sólo avance de filas de un origen de datos.

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

Herencia

Object

MarshalByRefObject

DbDataReader

EntityDataReader

Implementaciones

IDataRecord IExtendedDataRecord

Comentarios

Combina la funcionalidad de la clase DbDataReader y la interfaz IExtendedDataRecord.

Un EntityDataReader no tiene un constructor público. Solo se puede obtener a través de una de las sobrecargas del EntityCommand.ExecuteReader método .

SQL Server coloca los parámetros de salida de los procedimientos almacenados al final de la secuencia resultante, después de todos los conjuntos de resultados. Por consiguiente, para obtener los valores de los parámetros de salida, una aplicación debe consumir todos los registros en todos los conjuntos de resultados. Si la aplicación cierra EntityDataReader (con lo que también se cerraría DbDataReader), es posible que no se llenen los parámetros de salida.

EntityDataReader no consume implícitamente conjuntos de resultados para hacer que los parámetros de salida estén disponibles. Por lo tanto, considere los siguientes aspectos:

• EntityDataReader llama al método DbDataReader.NextResult solo cuando se llama explícitamente al método EntityDataReader.NextResult. Si DbDataReader.NextResult produce una excepción, la EntityDataReader encapsulará en una EntityException excepción (o una excepción derivada).

• Close solo cierra DbDataReader, sin consumir conjuntos de resultados o registros pendientes.

• Dispose solo elimina DbDataReader, sin consumir conjuntos de resultados o registros pendientes.

Para obtener ejemplos de código, consulte Trabajar con EntityClient.

Propiedades

DataRecordInfo	Obtiene DataRecordInfo para esta IExtendedDataRecord.
Depth	Obtiene un valor que indica la profundidad de anidamiento de la fila actual.
FieldCount	Obtiene el número de columnas de la fila actual.
HasRows	Obtiene un valor que indica si este EntityDataReader contiene una o varias filas.
IsClosed	Obtiene un valor que indica si EntityDataReader está cerrado.
Item[Int32]	Obtiene el valor de la columna especificada como una instancia de Object.
Item[String]	Obtiene el valor de la columna especificada como una instancia de Object.
RecordsAffected	Obtiene el número de filas cambiadas, insertadas o eliminadas mediante la ejecución de la instrucción SQL.
VisibleFieldCount	Obtiene el número de campos de EntityDataReader que no están ocultos.

Métodos

Close()	Cierra el objeto EntityDataReader.
CloseAsync()	Cierra de forma asincrónica el objeto DbDataReader. (Heredado de DbDataReader)
CreateObjRef(Type)	Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
Dispose()	Libera todos los recursos usados por la instancia actual de la clase DbDataReader. (Heredado de DbDataReader)
Dispose(Boolean)	Libera los recursos consumidos por este EntityDataReader y llama al método Close().
DisposeAsync()	Libera de forma asincrónica todos los recursos que usa la instancia actual de la clase DbDataReader. (Heredado de DbDataReader)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetBoolean(Int32)	Obtiene el valor de la columna especificada como tipo Boolean.
GetByte(Int32)	Obtiene el valor de la columna especificada como un byte.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Lee una secuencia de bytes de la columna especificada, a partir de la posición que indica dataIndex, y los copia en el búfer comenzando en la ubicación que indica bufferIndex.
GetChar(Int32)	Obtiene el valor de la columna especificada como un solo carácter.
GetChars(Int32, Int64, Char[], Int32, Int32)	Lee una secuencia de caracteres de la columna especificada, a partir de la posición que indica dataIndex, y los copia en el búfer comenzando en la ubicación que indica bufferIndex.
GetColumnSchemaAsync(CancellationToken)	Esta es la versión asincrónica de GetColumnSchema(DbDataReader). Los proveedores lo deben reemplazar con una implementación apropiada. Opcionalmente, se puede respetar cancellationToken. La implementación predeterminada invoca la llamada sincrónica a GetColumnSchema(DbDataReader) y devuelve una tarea completada. La implementación predeterminada devolverá una tarea cancelada si se pasa un cancellationToken ya cancelado. Las excepciones producidas por GetColumnSchema(DbDataReader) se comunicarán mediante la propiedad Task Exception devuelta. (Heredado de DbDataReader)
GetData(Int32)	Devuelve un lector de datos anidados para la columna solicitada. (Heredado de DbDataReader)
GetDataReader(Int32)	Devuelve lectores anidados como objetos DbDataReader.
GetDataRecord(Int32)	Devuelve un DbDataRecord anidado.
GetDataTypeName(Int32)	Obtiene el nombre del tipo de datos de la columna especificada.
GetDateTime(Int32)	Obtiene el valor de la columna especificada como un objeto DateTime.
GetDbDataReader(Int32)	Devuelve un objeto DbDataReader para el índice de columna solicitado que puede ser invalidado con una implementación específica del proveedor.
GetDecimal(Int32)	Obtiene el valor de la columna especificada como un objeto Decimal.
GetDouble(Int32)	Obtiene el valor de la columna especificada como un número de punto flotante de doble precisión.
GetEnumerator()	Devuelve una interfaz IEnumerator que se puede utilizar para recorrer en iteración las filas en el lector de datos.
GetFieldType(Int32)	Obtiene el tipo de datos de la columna especificada.
GetFieldValue<T>(Int32)	Obtiene el valor de la columna especificada con el tipo solicitado. (Heredado de DbDataReader)
GetFieldValueAsync<T>(Int32)	Obtiene de manera asincrónica el valor de la columna especificada con el tipo solicitado. (Heredado de DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)	Obtiene de manera asincrónica el valor de la columna especificada con el tipo solicitado. (Heredado de DbDataReader)
GetFloat(Int32)	Obtiene el valor de la columna especificada como un número de punto flotante de precisión sencilla.
GetGuid(Int32)	Obtiene el valor de la columna especificada como un identificador global único (GUID).
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetInt16(Int32)	Obtiene el valor de la columna especificada como un entero de 16 bits con signo.
GetInt32(Int32)	Obtiene el valor de la columna especificada como un entero con signo de 32 bits.
GetInt64(Int32)	Obtiene el valor de la columna especificada como un entero de 64 bits con signo.
GetLifetimeService()	Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
GetName(Int32)	Obtiene el nombre de la columna, dado el índice de columna de base cero.
GetOrdinal(String)	Obtiene el índice de columna dado el nombre de la misma.
GetProviderSpecificFieldType(Int32)	Devuelve el tipo de campo específico del proveedor de la columna especificada.
GetProviderSpecificValue(Int32)	Obtiene el valor de la columna especificada como una instancia de Object.
GetProviderSpecificValues(Object[])	Obtiene todas las columnas de atributos específicos del proveedor en la colección para la fila actual.
GetSchemaTable()	Devuelve un objeto DataTable que describe los metadatos de columna del DbDataReader.
GetSchemaTableAsync(CancellationToken)	Esta es la versión asincrónica de GetSchemaTable(). Los proveedores lo deben reemplazar con una implementación apropiada. Opcionalmente, se puede respetar cancellationToken. La implementación predeterminada invoca la llamada sincrónica a GetSchemaTable() y devuelve una tarea completada. La implementación predeterminada devolverá una tarea cancelada si se pasa un cancellationToken ya cancelado. Las excepciones producidas por GetSchemaTable() se comunicarán mediante la propiedad Task Exception devuelta. (Heredado de DbDataReader)
GetStream(Int32)	Obtiene un flujo para recuperar datos de la columna especificada. (Heredado de DbDataReader)
GetString(Int32)	Obtiene el valor de la columna especificada como una instancia de String.
GetTextReader(Int32)	Obtiene un lector de texto para recuperar datos de la columna. (Heredado de DbDataReader)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
GetValue(Int32)	Obtiene el valor de la columna especificada como una instancia de Object.
GetValues(Object[])	Rellena una matriz de objetos con los valores de columna de la fila actual.
InitializeLifetimeService()	Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
IsDBNull(Int32)	Obtiene un valor que indica si la columna contiene valores que no existen o ausentes.
IsDBNullAsync(Int32)	Obtiene de manera asincrónica un valor que indica si la columna contiene valores no existentes o que faltan. (Heredado de DbDataReader)
IsDBNullAsync(Int32, CancellationToken)	Obtiene de manera asincrónica un valor que indica si la columna contiene valores no existentes o que faltan. (Heredado de DbDataReader)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject)
NextResult()	Hace avanzar el lector hasta el resultado siguiente cuando se leen los resultados de un lote de instrucciones.
NextResultAsync()	Hace avanzar de manera asincrónica el lector hasta el resultado siguiente cuando se leen los resultados de un lote de instrucciones. (Heredado de DbDataReader)
NextResultAsync(CancellationToken)	Hace avanzar de manera asincrónica el lector hasta el resultado siguiente cuando se leen los resultados de un lote de instrucciones. (Heredado de DbDataReader)
Read()	Hace avanzar el lector hasta el siguiente registro de un conjunto de resultados.
ReadAsync()	Hace avanzar de manera asincrónica el lector hasta el siguiente registro de un conjunto de resultados. (Heredado de DbDataReader)
ReadAsync(CancellationToken)	Hace avanzar de manera asincrónica el lector hasta el siguiente registro de un conjunto de resultados. (Heredado de DbDataReader)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Implementaciones de interfaz explícitas

IDataRecord.GetData(Int32)

Para obtener una descripción de este miembro, vea GetData(Int32). (Heredado de DbDataReader)

Métodos de extensión

CanGetColumnSchema(DbDataReader)	Obtiene un valor que indica si DbDataReader puede obtener un esquema de columna.
GetColumnSchema(DbDataReader)	Obtiene el esquema de columna (colección DbColumn) para DbDataReader.
Cast<TResult>(IEnumerable)	Convierte los elementos de IEnumerable en el tipo especificado.
OfType<TResult>(IEnumerable)	Filtra los elementos de IEnumerable en función de un tipo especificado.
AsParallel(IEnumerable)	Habilita la paralelización de una consulta.
AsQueryable(IEnumerable)	Convierte una interfaz IEnumerable en IQueryable.