DbDataReader Classe

Definição

Lê um fluxo somente encaminhamento de linhas 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
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
DbDataReader
Herança
DbDataReader
Derivado
Implementações

Construtores

DbDataReader()

Inicializa uma nova instância da classe DbDataReader.

Propriedades

Depth

Obtém um valor que indica a profundidade do aninhamento para a 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 esse 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 no DbDataReader que não estão ocultos.

Métodos

Close()

Fecha o objeto DbDataReader.

CloseAsync()

Fecha assíncronamente 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 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(Int32)

Quando substituído em uma classe derivada, obtém o valor da coluna especificada como um único caractere.

GetChars(Int32, Int64, Char[], Int32, Int32)

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

GetColumnSchemaAsync(CancellationToken)

Esta é a versão assíncrona do GetColumnSchema(DbDataReader). Os provedores devem substituir com uma implementação apropriada. O cancellationToken pode, opcionalmente, ser honrado. A implementação padrão invoca a chamada síncrona GetColumnSchema(DbDataReader) e retorna uma tarefa concluída. A implementação padrão retornará uma tarefa cancelada se aprovada uma cancellationTokenjá cancelada. As exceções geradas por GetColumnSchema(DbDataReader) serão comunicadas por meio da propriedade de 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 de 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 por meio das 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 o tipo solicitado.

GetFieldValueAsync<T>(Int32, CancellationToken)

Obtém de forma assíncrona o valor da coluna especificada como o tipo solicitado.

GetFieldValueAsync<T>(Int32)

Obtém de forma assíncrona o valor da coluna especificada como o 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 única.

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 tempo de vida para essa instância.

(Herdado de MarshalByRefObject)
GetName(Int32)

Quando substituído em uma classe derivada, obtém o nome da coluna, considerando o ordinal de coluna baseado em zero.

GetOrdinal(String)

Quando substituído em uma classe derivada, obtém o ordinal de 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 da linha atual.

GetSchemaTable()

Retorna um DataTable que descreve os metadados de coluna do DbDataReader. Retorna null se o comando executado não retornou nenhum conjunto de resultados ou após NextResult() retornar false.

GetSchemaTableAsync(CancellationToken)

Esta é a versão assíncrona do GetSchemaTable(). Os provedores devem substituir com uma implementação apropriada. O cancellationToken pode, opcionalmente, ser honrado. A implementação padrão invoca a chamada síncrona GetSchemaTable() e retorna uma tarefa concluída. A implementação padrão retornará uma tarefa cancelada se aprovada uma cancellationTokenjá cancelada. As exceções geradas por GetSchemaTable() serão comunicadas por meio da propriedade de 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 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)

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

IsDBNullAsync(Int32)

Obtém de forma assíncrona um valor que indica se a coluna contém valores inexistentes ou ausentes.

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()

Quando substituído em uma classe derivada, avança o leitor para o próximo resultado ao ler os resultados de um lote de instruções.

NextResultAsync()

Avança de forma assíncrona o leitor para o próximo resultado ao ler os resultados de um lote de instruções.

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.

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 forma assíncrona o leitor para o próximo registro em um conjunto de resultados.

ReadAsync(CancellationToken)

Avança de forma 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, consulte Close().

IDataReader.GetSchemaTable()

Para obter uma descrição desse membro, consulte GetSchemaTable().

IDataRecord.GetData(Int32)

Para obter uma descrição desse membro, consulte 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 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.

Aplica-se a

Confira também

  • DbProviderFactories (ADO.NET)
  • visão geral ADO.NET