DataTableReader Classe

Definição

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Assembly:

System.Data.dll

Assembly:

netstandard.dll

O DataTableReader obtém o conteúdo de um ou mais objetos DataTable na forma de um ou mais conjuntos de resultados somente leitura de somente avanço.

public ref class DataTableReader sealed : System::Data::Common::DbDataReader

public sealed class DataTableReader : System.Data.Common.DbDataReader

type DataTableReader = class
    inherit DbDataReader

Public NotInheritable Class DataTableReader
Inherits DbDataReader

Herança

Object

MarshalByRefObject

DbDataReader

DataTableReader

Comentários

O DataTableReader funciona muito parecido com qualquer outro leitor de dados, como o SqlDataReader, exceto que o DataTableReader fornece para iteração em 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 a partir de um DataTable, o objeto resultante DataTableReader contém um conjunto de resultados com os mesmos dados DataTable dos quais ele foi criado, exceto para todas as linhas que foram marcadas como excluídas. As colunas aparecem na mesma ordem que no original DataTable. A estrutura do resultado retornado é idêntica no esquema e nos dados do original DataTable. Um DataTableReader que foi criado chamando o CreateDataReader método de um DataSet objeto contém vários conjuntos de resultados se ele DataSet contiver mais de uma tabela. Os resultados estão na mesma sequência que os DataTable objetos no DataTableCollection DataSet objeto.

O conjunto de resultados retornado contém apenas a versão atual de cada DataRow; as linhas marcadas para exclusão são ignoradas.

Ele 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 Rows coleção forem excluídas ou removidas durante a iteração, a posição atual dentro do DataTableReader iterador será mantida adequadamente e não invalidará o iterador.

Construtores

DataTableReader(DataTable)	Inicializa uma nova instância da classe DataTableReader usando dados do DataTable fornecido.
DataTableReader(DataTable[])	Inicializa uma nova instância da classe DataTableReader usando a matriz de objetos DataTable fornecida.

Propriedades

Depth	A profundidade de aninhamento da 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 de acordo com o ordinal da coluna.
Item[String]	Obtém o valor da coluna especificada em seu formato nativo de acordo com 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 em DbDataReader que não estão ocultos. (Herdado de DbDataReader)

Métodos

Close()	Fecha o DataTableReader atual.
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 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 no buffer como uma matriz iniciada 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)	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)
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 da 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 na coleção de item.
GetFieldType(Int32)	Obtém o Type que é o tipo de dados do objeto.
GetFieldValue<T>(Int32)	Obtém 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)
GetFieldValueAsync<T>(Int32, CancellationToken)	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 valor da coluna especificada como um String.
GetOrdinal(String)	Obtém a ordinal da coluna, de acordo com 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 da coluna do DataTableReader.
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 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 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 inexistente.
IsDBNullAsync(Int32)	Obtém, de maneira assíncrona, um valor que indica se a coluna contém valores ausentes ou inexistente. (Herdado de DbDataReader)
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)
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 DataTableReader para o próximo conjunto de resultados, se houver.
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 DataTableReader para o próximo registro.
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.
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 de bytes especificado da coluna especificada começando em um índice especificado e os grava 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 de caracteres especificado 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 um tipo solicitado.
GetFieldValueAsync<T>(DbDataReader, String, CancellationToken)	Obtém de forma assíncrona o valor da coluna especificada como um 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 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 ausentes ou inexistentes.
IsDBNullAsync(DbDataReader, String, CancellationToken)	Obtém, de maneira assíncrona, um valor que indica se a coluna contém valores ausentes ou inexistente.
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 são realizadas.