DataTableReader 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.
O DataTableReader obtém o conteúdo de um ou mais objetos DataTable na forma de um ou mais conjuntos de resultados de leitura e encaminhamento apenas.
public ref class DataTableReader sealed : System::Data::Common::DbDataReaderpublic sealed class DataTableReader : System.Data.Common.DbDataReadertype DataTableReader = class
inherit DbDataReaderPublic NotInheritable Class DataTableReader
Inherits DbDataReader- Herança
Observações
Funciona DataTableReader de forma semelhante a qualquer outro leitor de dados, como o SqlDataReader, exceto que permite DataTableReader iterar sobre linhas num DataTable. Por outras palavras, permite iterar sobre linhas numa cache. Os dados em cache podem ser modificados enquanto o DataTableReader está ativo, e o leitor mantém automaticamente a sua posição.
Quando crias um DataTableReader a partir de um DataTable, o objeto resultante DataTableReader contém um conjunto de resultados com os mesmos dados dos DataTable quais foi criado, exceto por quaisquer linhas que tenham sido marcadas como eliminadas. As colunas aparecem na mesma ordem do original DataTable. A estrutura do resultado devolvido é idêntica em esquema e dados ao original DataTable. A DataTableReader que foi criado ao chamar o CreateDataReader método de um DataSet objeto contém múltiplos conjuntos de resultados se o DataSet contiver mais do que uma tabela. Os resultados estão na mesma sequência que os DataTable objetos no DataTableCollection do DataSet objeto.
O conjunto de resultados devolvido contém apenas a versão atual de cada DataRow; as linhas marcadas para eliminação são ignoradas.
Fornece DataTableReader um iterador estável; ou seja, o conteúdo do DataTableReader não é invalidado se o tamanho da coleção subjacente for modificado durante a iteração. Por exemplo, se uma ou mais linhas da Rows coleção forem eliminadas ou removidas durante a iteração, a posição atual dentro do DataTableReader é mantida adequadamente e não invalida o iterador.
Construtores
| Name | Description |
|---|---|
| DataTableReader(DataTable) |
Inicializa uma nova instância da DataTableReader classe usando dados do .DataTable |
| DataTableReader(DataTable[]) |
Inicializa uma nova instância da DataTableReader classe usando o array de DataTable objetos fornecido. |
Propriedades
| Name | Description |
|---|---|
| Depth |
A profundidade de nidificação para a linha atual do DataTableReader. |
| FieldCount |
Devolve o número de colunas na linha atual. |
| HasRows |
Obtém um valor que indica se contém DataTableReader uma ou mais linhas. |
| IsClosed |
Obtém um valor que indica se o DataTableReader está fechado. |
| Item[Int32] |
Obtém o valor da coluna especificada no seu formato nativo dado o ordinal da coluna. |
| Item[String] |
Obtém o valor da coluna especificada no seu formato nativo, dado o nome da coluna. |
| RecordsAffected |
Obtém o número de linhas inseridas, alteradas ou eliminadas pela execução da instrução SQL. |
| VisibleFieldCount |
Obtém o número de campos no DbDataReader que não estão ocultos. (Herdado de DbDataReader) |
Métodos
| Name | Description |
|---|---|
| Close() |
Fecha a corrente DataTableReader. |
| CloseAsync() |
Fecha o DbDataReader objeto de forma assíncrona. (Herdado de DbDataReader) |
| 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 não geridos usados pelo DbDataReader e opcionalmente liberta os recursos geridos. (Herdado de DbDataReader) |
| DisposeAsync() |
Liberta assíncronamente todos os recursos usados pela instância atual da DbDataReader classe. (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 Boolean. |
| GetByte(Int32) |
Obtém o valor da coluna especificada como um byte. |
| GetBytes(Int32, Int64, Byte[], Int32, Int32) |
Lê um fluxo de bytes a partir do deslocamento da coluna especificado para o buffer como um array iniciado no deslocamento do buffer especificado. |
| GetChar(Int32) |
Obtém o valor da coluna especificada como um carácter. |
| GetChars(Int32, Int64, Char[], Int32, Int32) |
Devolve o valor da coluna especificada como um array de caracteres. |
| GetData(Int32) |
Devolve um leitor de dados aninhado para a coluna solicitada. (Herdado de DbDataReader) |
| GetDataTypeName(Int32) |
Obtém uma cadeia que representa o 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. (Herdado de DbDataReader) |
| GetDecimal(Int32) |
Obtém o valor da coluna especificada como um Decimal. |
| GetDouble(Int32) |
Obtém o valor da coluna como um número de ponto flutuante de dupla precisão. |
| GetEnumerator() |
Devolve um enumerador que pode ser usado para iterar na coleção de itens. |
| GetFieldType(Int32) |
Obtém-se que Type é o tipo de dado do objeto. |
| 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) |
Obtém o valor da coluna especificada como um String. |
| GetOrdinal(String) |
Obtém o ordinal da coluna, dado o nome da coluna. |
| GetProviderSpecificFieldType(Int32) |
Obtém o tipo da coluna especificada no formato específico do fornecedor. |
| GetProviderSpecificValue(Int32) |
Obtém o valor da coluna especificada no formato específico do fornecedor. |
| GetProviderSpecificValues(Object[]) |
Preenche o array fornecido com informação de tipo específica do fornecedor para todas as colunas do DataTableReader. |
| GetSchemaTable() |
Devolve um DataTable que descreve os metadados DataTableReaderda 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 cadeia. |
| 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 no seu formato nativo. |
| 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) |
Obtém 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 para DataTableReader o próximo conjunto de resultados, se houver. |
| 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 DataTableReader para o próximo disco. |
| 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. |
| ConfigureAwait(IAsyncDisposable, Boolean) |
Configura como aguarda nas tarefas devolvidas de um descartável assíncrono será realizada. |
| GetBoolean(DbDataReader, String) |
Obtém o valor da coluna especificada como um Booleano. |
| GetByte(DbDataReader, String) |
Obtém o valor da coluna especificada como um byte. |
| GetBytes(DbDataReader, String, Int64, Byte[], Int32, Int32) |
Lê um número especificado de bytes da coluna especificada a partir de um índice especificado e escreve-os num buffer a partir de uma posição especificada no buffer. |
| GetChar(DbDataReader, String) |
Obtém o valor da coluna especificada como um único carácter. |
| GetChars(DbDataReader, String, Int64, Char[], Int32, Int32) |
Lê um número especificado de caracteres de uma coluna determinada a partir de um índice especificado e escreve-os num buffer a partir de uma posição especificada. |
| GetColumnSchema(DbDataReader) |
Obtém o esquema de colunas (DbColumn coleção) para um DbDataReader. |
| GetData(DbDataReader, String) |
Devolve um leitor de dados aninhado para a coluna solicitada. |
| GetDataTypeName(DbDataReader, String) |
Obtém o nome do tipo de dado da coluna especificada. |
| GetDateTime(DbDataReader, String) |
Obtém o valor da coluna especificada como objeto DateTime . |
| GetDecimal(DbDataReader, String) |
Obtém o valor da coluna especificada como um Decimal. |
| GetDouble(DbDataReader, String) |
Obtém o valor da coluna especificada como um número de ponto flutuante de dupla precisão. |
| GetFieldType(DbDataReader, String) |
Obtém o tipo de dado da coluna especificada. |
| GetFieldValue<T>(DbDataReader, String) |
Recebe o valor da coluna especificada como o tipo solicitado. |
| GetFieldValueAsync<T>(DbDataReader, String, CancellationToken) |
Assíncrono, obtém o valor da coluna especificada como o tipo solicitado. |
| GetFloat(DbDataReader, String) |
Obtém o valor da coluna especificada como um número de ponto flutuante de precisão simples. |
| GetGuid(DbDataReader, String) |
Obtém o valor da coluna especificada como um identificador globalmente único (GUID). |
| GetInt16(DbDataReader, String) |
Obtém o valor da coluna especificada como um inteiro com assinatura de 16 bits. |
| GetInt32(DbDataReader, String) |
Obtém o valor da coluna especificada como um inteiro assinado de 32 bits. |
| GetInt64(DbDataReader, String) |
Obtém o valor da coluna especificada como um inteiro assinado de 64 bits. |
| GetProviderSpecificFieldType(DbDataReader, String) |
Obtém o tipo específico do fornecedor da coluna especificada. |
| GetProviderSpecificValue(DbDataReader, String) |
Obtém o valor da coluna especificada como uma instância de um tipo específico de fornecedor. |
| GetStream(DbDataReader, String) |
Recebe um fluxo para recuperar dados da coluna especificada. |
| GetString(DbDataReader, String) |
Obtém o valor da coluna especificada como uma instância de String. |
| GetTextReader(DbDataReader, String) |
Faz com que um leitor de texto recupere dados da coluna. |
| GetValue(DbDataReader, String) |
Obtém o valor da coluna especificada como uma instância de Object. |
| IsDBNull(DbDataReader, String) |
Recebe um valor que indica se a coluna contém valores inexistentes ou em falta. |
| IsDBNullAsync(DbDataReader, String, CancellationToken) |
De forma assíncrona, obtém um valor que indica se a coluna contém valores inexistentes ou em falta. |
| OfType<TResult>(IEnumerable) |
Filtra os elementos de um IEnumerable com base num tipo especificado. |