EntityDataReader Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Lê um fluxo apenas direto de linhas a partir de uma fonte de dados.
public ref class EntityDataReader : System::Data::Common::DbDataReader, System::Data::IExtendedDataRecordpublic class EntityDataReader : System.Data.Common.DbDataReader, System.Data.IExtendedDataRecordtype EntityDataReader = class
inherit DbDataReader
interface IExtendedDataRecord
interface IDataRecordPublic Class EntityDataReader
Inherits DbDataReader
Implements IExtendedDataRecord- Herança
- Implementações
Observações
Combina a funcionalidade da DbDataReader classe e da IExtendedDataRecord interface.
An EntityDataReader não tem construtor público. Só pode ser obtido através de uma das EntityCommand.ExecuteReader sobrecargas do método.
O SQL Server coloca os parâmetros de saída dos procedimentos armazenados no final do fluxo de resultados, após todos os conjuntos de resultados. Portanto, para obter valores dos parâmetros de saída, uma aplicação deve consumir todos os registos em todos os conjuntos de resultados. Se a aplicação fechar o EntityDataReader (o que também fecharia o DbDataReader), os parâmetros de saída podem não ser preenchidos.
EntityDataReader não consome implicitamente conjuntos de resultados para disponibilizar parâmetros de saída. Portanto, note o seguinte:
EntityDataReader chama o DbDataReader.NextResult apenas quando EntityDataReader.NextResult é explicitamente chamado. Se DbDataReader.NextResult lançar uma exceção, irá EntityDataReader envolvê-la numa EntityException (ou numa exceção derivada).
Close apenas fecha o DbDataReader, sem consumir quaisquer registos pendentes ou conjuntos de resultados.
Dispose apenas elimina o DbDataReader, sem consumir quaisquer registos pendentes ou conjuntos de resultados.
Para exemplos de código, veja Trabalhar com EntityClient.
Propriedades
| Name | Description |
|---|---|
| DataRecordInfo |
Recebe DataRecordInfo por isto IExtendedDataRecord. |
| Depth |
Obtém um valor que indica a profundidade de aninhamento para a linha atual. |
| FieldCount |
Obtém o número de colunas na linha atual. |
| HasRows |
Recebe um valor que indica se contém EntityDataReader 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 |
Faz com que o número de linhas seja alterado, inserido ou eliminado pela execução da instrução SQL. |
| VisibleFieldCount |
Obtém o número de campos no EntityDataReader que não estão ocultos. |
Métodos
| Name | Description |
|---|---|
| Close() |
Fecha o EntityDataReader objeto. |
| CreateObjRef(Type) |
Cria um objeto que contém toda a informação relevante necessária para gerar um proxy usado para comunicar com um objeto remoto. (Herdado de MarshalByRefObject) |
| Dispose() |
Liberta todos os recursos usados pela instância atual da DbDataReader classe. (Herdado de DbDataReader) |
| Dispose(Boolean) |
Liberta os recursos consumidos por isto EntityDataReader e chama Close(). |
| 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 Booleano. |
| GetByte(Int32) |
Obtém o valor da coluna especificada como um byte. |
| GetBytes(Int32, Int64, Byte[], Int32, Int32) |
Lê um fluxo de bytes da coluna especificada, começando na localização indicada por |
| GetChar(Int32) |
Obtém o valor da coluna especificada como um único carácter. |
| GetChars(Int32, Int64, Char[], Int32, Int32) |
Lê um fluxo de caracteres da coluna especificada, começando na localização indicada por |
| GetData(Int32) |
Devolve um leitor de dados aninhado para a coluna solicitada. (Herdado de DbDataReader) |
| GetDataReader(Int32) |
Devolve os leitores aninhados como DbDataReader objetos. |
| GetDataRecord(Int32) |
Devolve um aninhado DbDataRecord. |
| GetDataTypeName(Int32) |
Obtém o nome do tipo de dado da coluna especificada. |
| GetDateTime(Int32) |
Obtém o valor da coluna especificada como objeto DateTime . |
| GetDbDataReader(Int32) |
Devolve um DbDataReader objeto para o ordinal da coluna solicitado que pode ser sobreposto com uma implementação específica do fornecedor. |
| GetDecimal(Int32) |
Obtém o valor da coluna especificada como objeto Decimal . |
| GetDouble(Int32) |
Obtém o valor da coluna especificada como um número de ponto flutuante de dupla precisão. |
| GetEnumerator() |
Retorna e IEnumerator que pode ser usado para iterar pelas linhas no leitor de dados. |
| GetFieldType(Int32) |
Obtém o tipo de dado da coluna especificada. |
| GetFieldValue<T>(Int32) |
Recebe o valor da coluna especificada como o tipo solicitado. (Herdado de DbDataReader) |
| GetFieldValueAsync<T>(Int32, CancellationToken) |
Assíncrono, obtém o valor da coluna especificada como o tipo solicitado. (Herdado de DbDataReader) |
| GetFieldValueAsync<T>(Int32) |
Assíncrono, obtém o valor da coluna especificada como o 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 identificador globalmente único (GUID). |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetInt16(Int32) |
Obtém o valor da coluna especificada como um inteiro com assinatura de 16 bits. |
| GetInt32(Int32) |
Obtém o valor da coluna especificada como um inteiro assinado de 32 bits. |
| GetInt64(Int32) |
Obtém o valor da coluna especificada como um inteiro assinado de 64 bits. |
| GetLifetimeService() |
Recupera o objeto de serviço de tempo de vida atual que controla a política de vida útil neste caso. (Herdado de MarshalByRefObject) |
| GetName(Int32) |
Recebe o nome da coluna, dado o ordinal da coluna baseada em zeros. |
| GetOrdinal(String) |
Recebe o ordinal da coluna dado o nome da coluna. |
| GetProviderSpecificFieldType(Int32) |
Devolve o tipo de campo específico do fornecedor 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 atributos específicas do fornecedor na coleção para a linha atual. |
| GetSchemaTable() |
Devolve um DataTable que descreve os metadados DbDataReaderda coluna de . |
| GetStream(Int32) |
Recebe 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) |
Faz com que um leitor de texto recupere 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[]) |
Preenche um array de objetos com os valores das colunas da linha atual. |
| InitializeLifetimeService() |
Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso. (Herdado de MarshalByRefObject) |
| IsDBNull(Int32) |
Recebe um valor que indica se a coluna contém valores inexistentes ou em falta. |
| IsDBNullAsync(Int32, CancellationToken) |
De forma assíncrona, obtém um valor que indica se a coluna contém valores inexistentes ou em falta. (Herdado de DbDataReader) |
| IsDBNullAsync(Int32) |
De forma assíncrona, obtém um valor que indica se a coluna contém valores inexistentes ou em falta. (Herdado de DbDataReader) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| MemberwiseClone(Boolean) |
Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject) |
| NextResult() |
Avança o leitor para o resultado seguinte ao ler os resultados de um conjunto de declarações. |
| NextResultAsync() |
De forma assíncrona, avança o leitor para o resultado seguinte ao ler os resultados de um conjunto de instruções. (Herdado de DbDataReader) |
| NextResultAsync(CancellationToken) |
De forma assíncrona, avança o leitor para o resultado seguinte ao ler os resultados de um conjunto de instruções. (Herdado de DbDataReader) |
| Read() |
Avança o leitor para o registo seguinte num conjunto de resultados. |
| ReadAsync() |
De forma assíncrona, avança o leitor para o registo seguinte num conjunto de resultados. (Herdado de DbDataReader) |
| ReadAsync(CancellationToken) |
De forma assíncrona, avança o leitor para o registo seguinte num conjunto de resultados. (Herdado de DbDataReader) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
Implementações de Interface Explícita
| Name | Description |
|---|---|
| IDataRecord.GetData(Int32) |
Para uma descrição deste elemento, veja GetData(Int32). (Herdado de DbDataReader) |
Métodos da Extensão
| Name | Description |
|---|---|
| AsParallel(IEnumerable) |
Permite a paralelização de uma consulta. |
| AsQueryable(IEnumerable) |
Converte um IEnumerable para um IQueryable. |
| CanGetColumnSchema(DbDataReader) |
Obtém um valor que indica se um DbDataReader pode obter um esquema de coluna. |
| Cast<TResult>(IEnumerable) |
Conjura os elementos de an IEnumerable para o tipo especificado. |
| GetColumnSchema(DbDataReader) |
Obtém o esquema de colunas (DbColumn coleção) para um DbDataReader. |
| OfType<TResult>(IEnumerable) |
Filtra os elementos de um IEnumerable com base num tipo especificado. |