DbDataReader Classe

  • Referência

Definição

Namespace:
System.Data.Common
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

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

public ref class DbDataReader abstract : IDisposable, System::Collections::IEnumerable
public ref class DbDataReader abstract : MarshalByRefObject, IAsyncDisposable, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader
public ref class DbDataReader abstract : IDisposable, System::Collections::IEnumerable, System::Data::IDataReader
public ref class DbDataReader abstract : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader
public ref class DbDataReader abstract : MarshalByRefObject, System::Collections::IEnumerable, System::Data::IDataReader
public ref class DbDataReader abstract : MarshalByRefObject, IAsyncDisposable, System::Collections::IEnumerable, System::Data::IDataReader
public abstract class DbDataReader : IDisposable, System.Collections.IEnumerable
public abstract class DbDataReader : MarshalByRefObject, IAsyncDisposable, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader
public abstract class DbDataReader : IDisposable, System.Collections.IEnumerable, System.Data.IDataReader
public abstract class DbDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader
public abstract class DbDataReader : MarshalByRefObject, System.Collections.IEnumerable, System.Data.IDataReader
public abstract class DbDataReader : MarshalByRefObject, IAsyncDisposable, System.Collections.IEnumerable, System.Data.IDataReader
type DbDataReader = class
    interface IEnumerable
    interface IDisposable
type DbDataReader = class
    inherit MarshalByRefObject
    interface IEnumerable
    interface IDataReader
    interface IDataRecord
    interface IDisposable
    interface IAsyncDisposable
type DbDataReader = class
    interface IEnumerable
    interface IDataReader
    interface IDataRecord
    interface IDisposable
type DbDataReader = class
    inherit MarshalByRefObject
    interface IEnumerable
    interface IDataReader
    interface IDataRecord
    interface IDisposable
type DbDataReader = class
    inherit MarshalByRefObject
    interface IDataReader
    interface IDisposable
    interface IDataRecord
    interface IEnumerable
type DbDataReader = class
    inherit MarshalByRefObject
    interface IDataReader
    interface IEnumerable
    interface IDisposable
    interface IDataRecord
Public MustInherit Class DbDataReader
Implements IDisposable, IEnumerable
Public MustInherit Class DbDataReader
Inherits MarshalByRefObject
Implements IAsyncDisposable, IDataReader, IDisposable, IEnumerable
Public MustInherit Class DbDataReader
Implements IDataReader, IDisposable, IEnumerable
Public MustInherit Class DbDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerable
Public MustInherit Class DbDataReader
Inherits MarshalByRefObject
Implements IDataReader, IEnumerable
Public MustInherit Class DbDataReader
Inherits MarshalByRefObject
Implements IAsyncDisposable, IDataReader, IEnumerable
Herança
Object
DbDataReader
Herança
Object
MarshalByRefObject
DbDataReader
Derivado
Implementações
IEnumerable IDisposable IDataReader IDataRecord IAsyncDisposable

Construtores

DbDataReader()

Inicializa uma nova instância da classe DbDataReader.

Propriedades

Depth

Obtém um valor que indica a profundidade de aninhamento da linha atual.
FieldCount

Quando substituído em uma classe derivada, obtém o número de colunas na linha atual.
HasRows

Quando substituído em uma classe derivada, obtém um valor que indica se este DbDataReader contém uma ou mais linhas.
IsClosed

Quando substituído em uma classe derivada, obtém um valor que indica se o DbDataReader está fechado.
Item[Int32]

Quando substituído em uma classe derivada, obtém o valor da coluna especificada como uma instância de Object.
Item[String]

Quando substituído em uma classe derivada, obtém o valor da coluna especificada como uma instância de Object.
RecordsAffected

Quando substituído em uma classe derivada, 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 DbDataReader que não estão ocultos.

Métodos

Close()

Fecha o objeto DbDataReader.
CloseAsync()

Fecha de maneira assíncrona o objeto 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.
Dispose(Boolean)

Libera os recursos não gerenciados usados pelo DbDataReader e opcionalmente libera os recursos gerenciados.
DisposeAsync()

Libera de forma assíncrona todos os recursos usados pela instância atual da classe DbDataReader.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetBoolean(Int32)

Quando substituído em uma classe derivada, obtém o valor da coluna especificada como um booliano.
GetByte(Int32)

Quando substituído em uma classe derivada, obtém o valor da coluna especificada como um byte.
GetBytes(Int32, Int64, Byte[], Int32, Int32)

Quando substituído em uma classe derivada, 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(Int32)

Quando substituído em uma classe derivada, obtém o valor da coluna especificada como um caractere único.
GetChars(Int32, Int64, Char[], Int32, Int32)

Quando substituído em uma classe derivada, 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.
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.
GetData(Int32)

Retorna um leitor de dados aninhado para a coluna solicitada.
GetDataTypeName(Int32)

Quando substituído em uma classe derivada, obtém o nome do tipo de dados da coluna especificada.
GetDateTime(Int32)

Quando substituído em uma classe derivada, 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)

Quando substituído em uma classe derivada, obtém o valor da coluna especificada como um Decimal.
GetDouble(Int32)

Quando substituído em uma classe derivada, obtém o valor da coluna especificada como um número de ponto flutuante de precisão dupla.
GetEnumerator()

Quando substituído em uma classe derivada, retorna um enumerador que pode ser usado para iterar pelas linhas no leitor de dados.
GetFieldType(Int32)

Quando substituído em uma classe derivada, obtém o tipo de dados da coluna especificada.
GetFieldValue<T>(Int32)

Obtém o valor da coluna especificada como um tipo solicitado.
GetFieldValueAsync<T>(Int32)

Obtém de forma assíncrona o valor da coluna especificada como um tipo solicitado.
GetFieldValueAsync<T>(Int32, CancellationToken)

Obtém de forma assíncrona o valor da coluna especificada como um tipo solicitado.
GetFloat(Int32)

Quando substituído em uma classe derivada, obtém o valor da coluna especificada como um número de ponto flutuante de precisão simples.
GetGuid(Int32)

Quando substituído em uma classe derivada, 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)

Quando substituído em uma classe derivada, obtém o valor da coluna especificada como um inteiro com sinal de 16 bits.
GetInt32(Int32)

Quando substituído em uma classe derivada, obtém o valor da coluna especificada como um inteiro com sinal de 32 bits.
GetInt64(Int32)

Quando substituído em uma classe derivada, 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)

Quando substituído em uma classe derivada, obtém o nome da coluna, dado o ordinal da coluna baseado em zero.
GetOrdinal(String)

Quando substituído em uma classe derivada, obtém o ordinal da coluna dado o nome da coluna.
GetProviderSpecificFieldType(Int32)

Obtém o tipo específico do provedor da coluna especificada.
GetProviderSpecificValue(Int32)

Obtém o valor da coluna especificada como uma instância de um tipo específico do provedor.
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. Retorna null se o comando executado não retornou nenhum conjunto de resultados ou após NextResult() o retorno false.
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.
GetStream(Int32)

Obtém um fluxo para recuperar dados da coluna especificada.
GetString(Int32)

Quando substituído em uma classe derivada, 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.
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
GetValue(Int32)

Quando substituído em uma classe derivada, obtém o valor da coluna especificada como uma instância de Object.
GetValues(Object[])

Quando substituído em uma classe derivada, 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)

Quando substituído em uma classe derivada, obtém um valor que indica se a coluna tem valores ausentes ou inexistentes.
IsDBNullAsync(Int32)

Obtém, de maneira assíncrona, um valor que indica se a coluna contém valores ausentes ou inexistente.
IsDBNullAsync(Int32, CancellationToken)

Obtém, de maneira assíncrona, um valor que indica se a coluna contém valores ausentes ou inexistente.
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()

Quando substituído em uma classe derivada, 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.
NextResultAsync(CancellationToken)

Avança de maneira assíncrona o leitor para o resultado seguinte ao ler os resultados de um lote de instruções.
Read()

Quando substituído em uma classe derivada, 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.
ReadAsync(CancellationToken)

Avança de maneira assíncrona o leitor para o próximo registro em um conjunto de resultados.
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Implantações explícitas de interface

IDataReader.Close()

Para obter uma descrição desse membro, confira Close().
IDataReader.GetSchemaTable()

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

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

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.

Aplica-se a

Confira também