EntityDataReader Clase

Definición

Lee una secuencia de sólo avance de filas de un origen de datos.Reads a forward-only stream of rows from a data source.

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
Implementaciones

Comentarios

Combina la funcionalidad de la clase DbDataReader y la interfaz IExtendedDataRecord.Combines the functionality of the DbDataReader class and the IExtendedDataRecord interface.

Un EntityDataReader no tiene un constructor público.An EntityDataReader has no public constructor. Solo se puede obtener a través de una de EntityCommand.ExecuteReader las sobrecargas del método.It can only be obtained through one of the EntityCommand.ExecuteReader method overloads.

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.SQL Server puts output parameters from stored procedures at the end of the result stream, after all the result sets. 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.Therefore, to get output parameter values, an application must consume all the records in all the result sets. 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.If the application closes the EntityDataReader (which would also close the DbDataReader), output parameters might not be populated.

EntityDataReader no consume implícitamente conjuntos de resultados para hacer que los parámetros de salida estén disponibles.EntityDataReader does not implicitly consume result sets to make output parameters available. Por lo tanto, considere los siguientes aspectos:Therefore, note the following:

Para ver ejemplos de código, consulte trabajar con EntityClient.For code examples, see Working with EntityClient.

Propiedades

DataRecordInfo

Obtiene DataRecordInfo para esta IExtendedDataRecord.Gets DataRecordInfo for this IExtendedDataRecord.

Depth

Obtiene un valor que indica la profundidad de anidamiento de la fila actual.Gets a value indicating the depth of nesting for the current row.

FieldCount

Obtiene el número de columnas de la fila actual.Gets the number of columns in the current row.

HasRows

Obtiene un valor que indica si este EntityDataReader contiene una o varias filas.Gets a value that indicates whether this EntityDataReader contains one or more rows.

IsClosed

Obtiene un valor que indica si EntityDataReader está cerrado.Gets a value indicating whether the EntityDataReader is closed.

Item[Int32]

Obtiene el valor de la columna especificada como una instancia de Object.Gets the value of the specified column as an instance of Object.

Item[String]

Obtiene el valor de la columna especificada como una instancia de Object.Gets the value of the specified column as an instance of Object.

RecordsAffected

Obtiene el número de filas cambiadas, insertadas o eliminadas mediante la ejecución de la instrucción SQL.Gets the number of rows changed, inserted, or deleted by execution of the SQL statement.

VisibleFieldCount

Obtiene el número de campos de EntityDataReader que no están ocultos.Gets the number of fields in the EntityDataReader that are not hidden.

Métodos

Close()

Cierra el objeto EntityDataReader.Closes the EntityDataReader object.

CloseAsync()

Cierra de forma asincrónica el objeto DbDataReader.Asynchronously closes the DbDataReader object.

(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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Heredado de MarshalByRefObject)
Dispose()

Libera todos los recursos usados por la instancia actual de la clase DbDataReader.Releases all resources used by the current instance of the DbDataReader class.

(Heredado de DbDataReader)
Dispose(Boolean)

Libera los recursos consumidos por este EntityDataReader y llama al método Close().Releases the resources consumed by this EntityDataReader and calls Close().

DisposeAsync()

Libera de forma asincrónica todos los recursos que usa la instancia actual de la clase DbDataReader.Asynchronously releases all resources used by the current instance of the DbDataReader class.

(Heredado de DbDataReader)
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetBoolean(Int32)

Obtiene el valor de la columna especificada como tipo Boolean.Gets the value of the specified column as a Boolean.

GetByte(Int32)

Obtiene el valor de la columna especificada como un byte.Gets the value of the specified column as a 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.Reads a stream of bytes from the specified column, starting at location indicated by dataIndex, into the buffer, starting at the location indicated by bufferIndex.

GetChar(Int32)

Obtiene el valor de la columna especificada como un único carácter.Gets the value of the specified column as a single character.

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.Reads a stream of characters from the specified column, starting at location indicated by dataIndex, into the buffer, starting at the location indicated by bufferIndex.

GetData(Int32)

Devuelve un lector de datos anidados para la columna solicitada.Returns a nested data reader for the requested column.

(Heredado de DbDataReader)
GetDataReader(Int32)

Devuelve lectores anidados como objetos DbDataReader.Returns nested readers as DbDataReader objects.

GetDataRecord(Int32)

Devuelve un DbDataRecord anidado.Returns a nested DbDataRecord.

GetDataTypeName(Int32)

Obtiene el nombre del tipo de datos de la columna especificada.Gets the name of the data type of the specified column.

GetDateTime(Int32)

Obtiene el valor de la columna especificada como un objeto DateTime.Gets the value of the specified column as a DateTime object.

GetDbDataReader(Int32)

Devuelve un objeto DbDataReader para el índice de columna solicitado que puede ser invalidado con una implementación específica del proveedor.Returns a DbDataReader object for the requested column ordinal that can be overridden with a provider-specific implementation.

GetDecimal(Int32)

Obtiene el valor de la columna especificada como un objeto Decimal.Gets the value of the specified column as a Decimal object.

GetDouble(Int32)

Obtiene el valor de la columna especificada como un número de punto flotante de precisión doble.Gets the value of the specified column as a double-precision floating point number.

GetEnumerator()

Devuelve una interfaz IEnumerator que se puede utilizar para recorrer en iteración las filas en el lector de datos.Returns an IEnumerator that can be used to iterate through the rows in the data reader.

GetFieldType(Int32)

Obtiene el tipo de datos de la columna especificada.Gets the data type of the specified column.

GetFieldValue<T>(Int32)

Obtiene el valor de la columna especificada con el tipo solicitado.Gets the value of the specified column as the requested type.

(Heredado de DbDataReader)
GetFieldValueAsync<T>(Int32)

Obtiene de manera asincrónica el valor de la columna especificada con el tipo solicitado.Asynchronously gets the value of the specified column as the requested type.

(Heredado de DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)

Obtiene de manera asincrónica el valor de la columna especificada con el tipo solicitado.Asynchronously gets the value of the specified column as the requested type.

(Heredado de DbDataReader)
GetFloat(Int32)

Obtiene el valor de la columna especificada como un número de punto flotante de precisión sencilla.Gets the value of the specified column as a single-precision floating point number.

GetGuid(Int32)

Obtiene el valor de la columna especificada como un identificador global único (GUID).Gets the value of the specified column as a globally-unique identifier (GUID).

GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetInt16(Int32)

Obtiene el valor de la columna especificada como un entero de 16 bits con signo.Gets the value of the specified column as a 16-bit signed integer.

GetInt32(Int32)

Obtiene el valor de la columna especificada como un entero con signo de 32 bits.Gets the value of the specified column as a 32-bit signed integer.

GetInt64(Int32)

Obtiene el valor de la columna especificada como un entero de 64 bits con signo.Gets the value of the specified column as a 64-bit signed integer.

GetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
GetName(Int32)

Obtiene el nombre de la columna, dado el índice de columna de base cero.Gets the name of the column, given the zero-based column ordinal.

GetOrdinal(String)

Obtiene el índice de columna dado el nombre de la misma.Gets the column ordinal given the name of the column.

GetProviderSpecificFieldType(Int32)

Devuelve el tipo de campo específico del proveedor de la columna especificada.Returns the provider-specific field type of the specified column.

GetProviderSpecificValue(Int32)

Obtiene el valor de la columna especificada como una instancia de Object.Gets the value of the specified column as an instance of Object.

GetProviderSpecificValues(Object[])

Obtiene todas las columnas de atributos específicos del proveedor en la colección para la fila actual.Gets all provider-specific attribute columns in the collection for the current row.

GetSchemaTable()

Devuelve un objeto DataTable que describe los metadatos de columna del DbDataReader.Returns a DataTable that describes the column metadata of the DbDataReader.

GetStream(Int32)

Obtiene un flujo para recuperar datos de la columna especificada.Gets a stream to retrieve data from the specified column.

(Heredado de DbDataReader)
GetString(Int32)

Obtiene el valor de la columna especificada como una instancia de String.Gets the value of the specified column as an instance of String.

GetTextReader(Int32)

Obtiene un lector de texto para recuperar datos de la columna.Gets a text reader to retrieve data from the column.

(Heredado de DbDataReader)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
GetValue(Int32)

Obtiene el valor de la columna especificada como una instancia de Object.Gets the value of the specified column as an instance of Object.

GetValues(Object[])

Rellena una matriz de objetos con los valores de columna de la fila actual.Populates an array of objects with the column values of the current row.

InitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
IsDBNull(Int32)

Obtiene un valor que indica si la columna contiene valores que no existen o ausentes.Gets a value that indicates whether the column contains nonexistent or missing values.

IsDBNullAsync(Int32)

Obtiene de manera asincrónica un valor que indica si la columna contiene valores no existentes o que faltan.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

(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.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

(Heredado de DbDataReader)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.Creates a shallow copy of the current MarshalByRefObject object.

(Heredado de MarshalByRefObject)
NextResult()

Hace avanzar el lector hasta el resultado siguiente cuando se leen los resultados de un lote de instrucciones.Advances the reader to the next result when reading the results of a batch of statements.

NextResultAsync()

Hace avanzar de manera asincrónica el lector hasta el resultado siguiente cuando se leen los resultados de un lote de instrucciones.Asynchronously advances the reader to the next result when reading the results of a batch of statements.

(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.Asynchronously advances the reader to the next result when reading the results of a batch of statements.

(Heredado de DbDataReader)
Read()

Hace avanzar el lector hasta el siguiente registro de un conjunto de resultados.Advances the reader to the next record in a result set.

ReadAsync()

Hace avanzar de manera asincrónica el lector hasta el siguiente registro de un conjunto de resultados.Asynchronously advances the reader to the next record in a result set.

(Heredado de DbDataReader)
ReadAsync(CancellationToken)

Hace avanzar de manera asincrónica el lector hasta el siguiente registro de un conjunto de resultados.Asynchronously advances the reader to the next record in a result set.

(Heredado de DbDataReader)
ToString()

Devuelve un valor de tipo string que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Implementaciones de interfaz explícitas

IDataReader.Close()

Para una descripción de este miembro, vea Close().For a description of this member, see Close().

(Heredado de DbDataReader)
IDataReader.GetSchemaTable()

Para una descripción de este miembro, vea GetSchemaTable().For a description of this member, see GetSchemaTable().

(Heredado de DbDataReader)
IDataRecord.GetData(Int32)

Para una descripción de este miembro, vea GetData(Int32).For a description of this member, see 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.Gets a value that indicates whether a DbDataReader can get a column schema.

GetColumnSchema(DbDataReader)

Obtiene el esquema de columna (colección DbColumn) para DbDataReader.Gets the column schema (DbColumn collection) for a DbDataReader.

Cast<TResult>(IEnumerable)

Convierte los elementos de IEnumerable en el tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra los elementos de IEnumerable en función de un tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita la paralelización de una consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convierte una interfaz IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

Se aplica a