EntityDataReader Classe

Referência

Definição

Namespace:: System.Data.EntityClient

Assembly:: System.Data.Entity.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Lê um fluxo de linhas apenas de encaminhamento a partir de uma fonte de dados.

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

Herança: Object

MarshalByRefObject

DbDataReader
EntityDataReader

Implementações: IDataRecord IExtendedDataRecord

Comentários

Combina a funcionalidade da DbDataReader classe e da IExtendedDataRecord interface.

Um EntityDataReader não tem construtor público. Ele só pode ser obtido por meio de uma das sobrecargas de EntityCommand.ExecuteReader método.

O SQL Server coloca parâmetros de saída de procedimentos armazenados no final do fluxo de resultados, após todos os conjuntos de resultados. Portanto, para obter valores de parâmetro de saída, um aplicativo deve consumir todos os registros em todos os conjuntos de resultados. Se o aplicativo fechar o EntityDataReader (que também fecharia o ), os DbDataReaderparâmetros de saída poderão não ser preenchidos.

EntityDataReader não consome implicitamente conjuntos de resultados para disponibilizar parâmetros de saída. Portanto, observe o seguinte:

EntityDataReader chama o DbDataReader.NextResult somente quando EntityDataReader.NextResult é chamado explicitamente. Se DbDataReader.NextResult gerar uma exceção, o a EntityDataReader encapsulará em uma EntityException (ou uma exceção derivada).
Close fecha apenas o DbDataReader, sem consumir registros pendentes ou conjuntos de resultados.
Dispose descarta apenas o DbDataReader, sem consumir registros pendentes ou conjuntos de resultados.

Para obter exemplos de código, consulte Trabalhando com EntityClient.

Propriedades

DataRecordInfo	Obtém DataRecordInfo para este IExtendedDataRecord.
Depth	Obtém um valor que indica a profundidade de aninhamento da linha atual.
FieldCount	Obtém o número de colunas na linha atual.
HasRows	Obtém um valor que indica se este EntityDataReader contém uma ou mais linhas.
IsClosed	Obtém um valor que indica se o EntityDataReader está fechado.
Item[Int32]	Obtém o valor da coluna especificada como uma instância de Object.
Item[String]	Obtém o valor da coluna especificada como uma instância de Object.
RecordsAffected	Obtém o número de linhas alteradas, inseridas ou excluídas pela execução da instrução SQL.
VisibleFieldCount	Obtém o número de campos em EntityDataReader que não estão ocultos.

Métodos

Close()	Fecha o objeto EntityDataReader.
CloseAsync()	Fecha de maneira assíncrona o objeto DbDataReader. (Herdado de DbDataReader)
CreateObjRef(Type)	Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
Dispose()	Libera todos os recursos usados pela instância atual da classe DbDataReader. (Herdado de DbDataReader)
Dispose(Boolean)	Libera os recursos consumidos por este EntityDataReader e chama Close().
DisposeAsync()	Libera de forma assíncrona todos os recursos usados pela instância atual da classe DbDataReader. (Herdado de DbDataReader)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetBoolean(Int32)	Obtém o valor da coluna especificada como um booliano.
GetByte(Int32)	Obtém o valor da coluna especificada como um byte.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Lê um fluxo de bytes na coluna especificada, iniciando no local indicado por `dataIndex`, no buffer, iniciando na posição indicada por `bufferIndex`.
GetChar(Int32)	Obtém o valor da coluna especificada como um único caractere.
GetChars(Int32, Int64, Char[], Int32, Int32)	Lê um fluxo de caracteres na coluna especificada, iniciando no local indicado por `dataIndex`, no buffer, iniciando na posição indicada por `bufferIndex`.
GetColumnSchemaAsync(CancellationToken)	Essa é a versão assíncrona de GetColumnSchema(DbDataReader). Provedores devem substituir com uma implementação apropriada. Opcionalmente, o `cancellationToken` pode ser respeitado. A implementação padrão invoca a chamada GetColumnSchema(DbDataReader) síncrona e retorna uma tarefa concluída. A implementação padrão retornará uma tarefa cancelada se já tiver passado um `cancellationToken` cancelado. Exceções geradas por GetColumnSchema(DbDataReader) serão comunicadas por meio da propriedade Exceção de Tarefa retornada. (Herdado de DbDataReader)
GetData(Int32)	Retorna um leitor de dados aninhado para a coluna solicitada. (Herdado de DbDataReader)
GetDataReader(Int32)	Retorna os leitores aninhados como objetos DbDataReader.
GetDataRecord(Int32)	Retorna um DbDataRecord aninhado.
GetDataTypeName(Int32)	Obtém o nome do tipo de dados da coluna especificada.
GetDateTime(Int32)	Obtém o valor da coluna especificada como um objeto DateTime.
GetDbDataReader(Int32)	Retorna um objeto DbDataReader para o ordinal da coluna solicitado que pode ser substituído por uma implementação específica do provedor.
GetDecimal(Int32)	Obtém o valor da coluna especificada como um objeto Decimal.
GetDouble(Int32)	Obtém o valor da coluna especificada como um número de ponto flutuante de precisão dupla.
GetEnumerator()	Retorna um IEnumerator que pode ser usado para iterar pelas linhas do leitor de dados.
GetFieldType(Int32)	Obtém o tipo de dados da coluna especificada.
GetFieldValue<T>(Int32)	Obtém o valor da coluna especificada como um tipo solicitado. (Herdado de DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)	Obtém de forma assíncrona o valor da coluna especificada como um tipo solicitado. (Herdado de DbDataReader)
GetFieldValueAsync<T>(Int32)	Obtém de forma assíncrona o valor da coluna especificada como um tipo solicitado. (Herdado de DbDataReader)
GetFloat(Int32)	Obtém o valor da coluna especificada como um número de ponto flutuante de precisão simples.
GetGuid(Int32)	Obtém o valor da coluna especificada como um GUID (identificador global exclusivo).
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetInt16(Int32)	Obtém o valor da coluna especificada como um inteiro com sinal de 16 bits.
GetInt32(Int32)	Obtém o valor da coluna especificada como um inteiro com sinal de 32 bits.
GetInt64(Int32)	Obtém o valor da coluna especificada como um inteiro com sinal de 64 bits.
GetLifetimeService()	Obsoleto. Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject)
GetName(Int32)	Obtém o nome da coluna, dado o ordinal da coluna com base em zero.
GetOrdinal(String)	Obtém o ordinal da coluna, de acordo com o nome da coluna.
GetProviderSpecificFieldType(Int32)	Retorna o tipo de campo específico do provedor da coluna especificada.
GetProviderSpecificValue(Int32)	Obtém o valor da coluna especificada como uma instância de Object.
GetProviderSpecificValues(Object[])	Obtém todas as colunas de atributo específicas do provedor na coleção para a linha atual.
GetSchemaTable()	Retorna um DataTable que descreve os metadados da coluna do DbDataReader.
GetSchemaTableAsync(CancellationToken)	Essa é a versão assíncrona de GetSchemaTable(). Provedores devem substituir com uma implementação apropriada. Opcionalmente, o `cancellationToken` pode ser respeitado. A implementação padrão invoca a chamada GetSchemaTable() síncrona e retorna uma tarefa concluída. A implementação padrão retornará uma tarefa cancelada se já tiver passado um `cancellationToken` cancelado. Exceções geradas por GetSchemaTable() serão comunicadas por meio da propriedade Exceção de Tarefa retornada. (Herdado de DbDataReader)
GetStream(Int32)	Obtém um fluxo para recuperar dados da coluna especificada. (Herdado de DbDataReader)
GetString(Int32)	Obtém o valor da coluna especificada como uma instância de String.
GetTextReader(Int32)	Obtém um leitor de texto para recuperar dados da coluna. (Herdado de DbDataReader)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetValue(Int32)	Obtém o valor da coluna especificada como uma instância de Object.
GetValues(Object[])	Popula uma matriz de objetos com os valores da coluna da linha atual.
InitializeLifetimeService()	Obsoleto. Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject)
IsDBNull(Int32)	Obtém um valor que indica se a coluna contém valores ausentes ou inexistentes.
IsDBNullAsync(Int32, CancellationToken)	Obtém, de maneira assíncrona, um valor que indica se a coluna contém valores ausentes ou inexistente. (Herdado de DbDataReader)
IsDBNullAsync(Int32)	Obtém, de maneira assíncrona, um valor que indica se a coluna contém valores ausentes ou inexistente. (Herdado de DbDataReader)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
NextResult()	Avança o leitor para o resultado seguinte ao ler os resultados de um lote de instruções.
NextResultAsync()	Avança de maneira assíncrona o leitor para o resultado seguinte ao ler os resultados de um lote de instruções. (Herdado de DbDataReader)
NextResultAsync(CancellationToken)	Avança de maneira assíncrona o leitor para o resultado seguinte ao ler os resultados de um lote de instruções. (Herdado de DbDataReader)
Read()	Avança o leitor para o próximo registro em um conjunto de resultados.
ReadAsync()	Avança de maneira assíncrona o leitor para o próximo registro em um conjunto de resultados. (Herdado de DbDataReader)
ReadAsync(CancellationToken)	Avança de maneira assíncrona o leitor para o próximo registro em um conjunto de resultados. (Herdado de DbDataReader)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Implantações explícitas de interface

IDataRecord.GetData(Int32)

Para obter uma descrição desse membro, confira GetData(Int32).

(Herdado de DbDataReader)

Métodos de Extensão

CanGetColumnSchema(DbDataReader)	Obtém um valor que indica se um DbDataReader pode obter um esquema de coluna.
GetColumnSchema(DbDataReader)	Obtém o esquema da coluna (coleção DbColumn) para um DbDataReader.
Cast<TResult>(IEnumerable)	Converte os elementos de um IEnumerable para o tipo especificado.
OfType<TResult>(IEnumerable)	Filtra os elementos de um IEnumerable com base em um tipo especificado.
AsParallel(IEnumerable)	Habilita a paralelização de uma consulta.
AsQueryable(IEnumerable)	Converte um IEnumerable em um IQueryable.

Aplica-se a

Partilhar via