DataTableReader Classe
Definição
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.
O DataTableReader obtém o conteúdo de um ou mais objetos DataTable na forma de um ou mais conjuntos de resultados somente leitura e somente encaminhamento.
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
Comentários
O DataTableReader funciona muito parecido com qualquer outro leitor de dados, como o SqlDataReader, exceto que o DataTableReader fornece para iterar sobre linhas em um DataTable. Em outras palavras, ele fornece a iteração em linhas em um cache. Os dados armazenados em cache podem ser modificados enquanto o DataTableReader está ativo e o leitor mantém automaticamente sua posição.
Quando você cria um DataTableReader de um DataTable, o objeto DataTableReader resultante contém um conjunto de resultados com os mesmos dados que o DataTable do qual foi criado, exceto para todas as linhas que foram marcadas como excluídas. As colunas aparecem na mesma ordem que no DataTableoriginal. A estrutura do resultado retornado é idêntica em esquema e dados à DataTableoriginal. Um DataTableReader criado chamando o método CreateDataReader de um objeto DataSet contém vários conjuntos de resultados se o DataSet contiver mais de uma tabela. Os resultados estão na mesma sequência que os objetos DataTable no DataTableCollection do objeto DataSet.
O conjunto de resultados retornado contém apenas a versão atual de cada DataRow; linhas marcadas para exclusão são ignoradas.
O DataTableReader fornece um iterador estável; ou seja, o conteúdo do DataTableReader não será invalidado se o tamanho da coleção subjacente for modificado durante a iteração. Por exemplo, se uma ou mais linhas na coleção Rows forem excluídas ou removidas durante a iteração, a posição atual no DataTableReader será mantida adequadamente e não invalida o iterador.
Construtores
| Nome | Description |
|---|---|
| DataTableReader(DataTable) |
Inicializa uma nova instância da classe DataTableReader usando dados do DataTablefornecido. |
| DataTableReader(DataTable[]) |
Inicializa uma nova instância da classe DataTableReader usando a matriz fornecida de objetos DataTable. |
Propriedades
| Nome | Description |
|---|---|
| Depth |
A profundidade do aninhamento para a linha atual do DataTableReader. |
| FieldCount |
Retorna o número de colunas na linha atual. |
| HasRows |
Obtém um valor que indica se o DataTableReader contém 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 em seu formato nativo, considerando o ordinal da coluna. |
| Item[String] |
Obtém o valor da coluna especificada em seu formato nativo dado o nome da coluna. |
| RecordsAffected |
Obtém o número de linhas inseridas, alteradas ou excluídas 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
| Nome | Description |
|---|---|
| Close() |
Fecha o DataTableReaderatual. |
| CloseAsync() |
Fecha assíncronamente 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 não gerenciados usados pelo DbDataReader e, opcionalmente, libera os recursos gerenciados. (Herdado de DbDataReader) |
| 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 Boolean. |
| GetByte(Int32) |
Obtém o valor da coluna especificada como um byte. |
| GetBytes(Int32, Int64, Byte[], Int32, Int32) |
Lê um fluxo de bytes começando no deslocamento de coluna especificado para o buffer como uma matriz começando no deslocamento de buffer especificado. |
| GetChar(Int32) |
Obtém o valor da coluna especificada como um caractere. |
| GetChars(Int32, Int64, Char[], Int32, Int32) |
Retorna o valor da coluna especificada como uma matriz de caracteres. |
| GetColumnSchemaAsync(CancellationToken) |
Esta é a versão assíncrona do GetColumnSchema(DbDataReader).
Os provedores devem substituir com uma implementação apropriada.
O |
| GetData(Int32) |
Retorna um leitor de dados aninhado para a coluna solicitada. (Herdado de DbDataReader) |
| GetDataTypeName(Int32) |
Obtém uma cadeia de caracteres que representa o 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 de coluna solicitado que pode ser substituído por uma implementação específica do provedor. (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 precisão dupla. |
| GetEnumerator() |
Retorna um enumerador que pode ser usado para iterar por meio da coleção de itens. |
| GetFieldType(Int32) |
Obtém o Type que é o tipo de dados do objeto. |
| GetFieldValue<T>(Int32) |
Obtém o valor da coluna especificada como o tipo solicitado. (Herdado de DbDataReader) |
| GetFieldValueAsync<T>(Int32, CancellationToken) |
Obtém de forma assíncrona o valor da coluna especificada como o tipo solicitado. (Herdado de DbDataReader) |
| GetFieldValueAsync<T>(Int32) |
Obtém de forma assíncrona 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 única. |
| 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 tempo de vida para essa instância. (Herdado de MarshalByRefObject) |
| GetName(Int32) |
Obtém o valor da coluna especificada como um String. |
| GetOrdinal(String) |
Obtém o ordinal de coluna, dado o nome da coluna. |
| GetProviderSpecificFieldType(Int32) |
Obtém o tipo da coluna especificada no formato específico do provedor. |
| GetProviderSpecificValue(Int32) |
Obtém o valor da coluna especificada no formato específico do provedor. |
| GetProviderSpecificValues(Object[]) |
Preenche a matriz fornecida com informações de tipo específicas do provedor para todas as colunas no DataTableReader. |
| GetSchemaTable() |
Retorna um DataTable que descreve os metadados de coluna do DataTableReader. |
| GetSchemaTableAsync(CancellationToken) |
Esta é a versão assíncrona do GetSchemaTable().
Os provedores devem substituir com uma implementação apropriada.
O |
| 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 cadeia de caracteres. |
| 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 em seu formato nativo. |
| GetValues(Object[]) |
Popula uma matriz de objetos com os valores de 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 dessa instância. (Herdado de MarshalByRefObject) |
| IsDBNull(Int32) |
Obtém um valor que indica se a coluna contém valores inexistentes ou ausentes. |
| IsDBNullAsync(Int32, CancellationToken) |
Obtém de forma assíncrona um valor que indica se a coluna contém valores inexistentes ou ausentes. (Herdado de DbDataReader) |
| IsDBNullAsync(Int32) |
Obtém de forma assíncrona um valor que indica se a coluna contém valores inexistentes ou ausentes. (Herdado de DbDataReader) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| MemberwiseClone(Boolean) |
Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject) |
| NextResult() |
Avança o DataTableReader para o próximo conjunto de resultados, se houver. |
| NextResultAsync() |
Avança de forma assíncrona o leitor para o próximo resultado ao ler os resultados de um lote de instruções. (Herdado de DbDataReader) |
| NextResultAsync(CancellationToken) |
Avança de forma assíncrona o leitor para o próximo resultado ao ler os resultados de um lote de instruções. (Herdado de DbDataReader) |
| Read() |
Avança o DataTableReader para o próximo registro. |
| ReadAsync() |
Avança de forma assíncrona o leitor para o próximo registro em um conjunto de resultados. (Herdado de DbDataReader) |
| ReadAsync(CancellationToken) |
Avança de forma 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
| Nome | Description |
|---|---|
| IDataRecord.GetData(Int32) |
Para obter uma descrição desse membro, consulte GetData(Int32). (Herdado de DbDataReader) |
Métodos de Extensão
| Nome | Description |
|---|---|
| CanGetColumnSchema(DbDataReader) |
Obtém um valor que indica se um DbDataReader pode obter um esquema de coluna. |
| GetColumnSchema(DbDataReader) |
Obtém o esquema de coluna (coleçãoDbColumn) para um DbDataReader. |
| GetBoolean(DbDataReader, String) |
Obtém o valor da coluna especificada como um booliano. |
| 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 começando em um índice especificado e grava-os em um buffer começando em uma posição especificada no buffer. |
| GetChar(DbDataReader, String) |
Obtém o valor da coluna especificada como um único caractere. |
| GetChars(DbDataReader, String, Int64, Char[], Int32, Int32) |
Lê um número especificado de caracteres de uma coluna especificada começando em um índice especificado e os grava em um buffer começando em uma posição especificada. |
| GetData(DbDataReader, String) |
Retorna um leitor de dados aninhado para a coluna solicitada. |
| GetDataTypeName(DbDataReader, String) |
Obtém o nome do tipo de dados da coluna especificada. |
| GetDateTime(DbDataReader, String) |
Obtém o valor da coluna especificada como um 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 precisão dupla. |
| GetFieldType(DbDataReader, String) |
Obtém o tipo de dados da coluna especificada. |
| GetFieldValue<T>(DbDataReader, String) |
Obtém o valor da coluna especificada como o tipo solicitado. |
| GetFieldValueAsync<T>(DbDataReader, String, CancellationToken) |
Obtém de forma assíncrona 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 única. |
| GetGuid(DbDataReader, String) |
Obtém o valor da coluna especificada como um GUID (identificador global exclusivo). |
| GetInt16(DbDataReader, String) |
Obtém o valor da coluna especificada como um inteiro com sinal de 16 bits. |
| GetInt32(DbDataReader, String) |
Obtém o valor da coluna especificada como um inteiro com sinal de 32 bits. |
| GetInt64(DbDataReader, String) |
Obtém o valor da coluna especificada como um inteiro com sinal de 64 bits. |
| GetProviderSpecificFieldType(DbDataReader, String) |
Obtém o tipo específico do provedor da coluna especificada. |
| GetProviderSpecificValue(DbDataReader, String) |
Obtém o valor da coluna especificada como uma instância de um tipo específico do provedor. |
| GetStream(DbDataReader, String) |
Obtém 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) |
Obtém um leitor de texto para recuperar dados da coluna. |
| GetValue(DbDataReader, String) |
Obtém o valor da coluna especificada como uma instância de Object. |
| IsDBNull(DbDataReader, String) |
Obtém um valor que indica se a coluna contém valores inexistentes ou ausentes. |
| IsDBNullAsync(DbDataReader, String, CancellationToken) |
Obtém de forma assíncrona um valor que indica se a coluna contém valores inexistentes ou ausentes. |
| 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. |
| ConfigureAwait(IAsyncDisposable, Boolean) |
Configura como as esperas nas tarefas retornadas de um descartável assíncrono serão executadas. |
