DbDataReader Classe

Definição

Lê um fluxo de linhas apenas de encaminhamento a partir de uma fonte de dados.Reads a forward-only stream of rows from a data source.

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
DbDataReader
Herança
DbDataReader
Derivado
Implementações

Construtores

DbDataReader()

Inicializa uma nova instância da classe DbDataReader.Initializes a new instance of the DbDataReader class.

Propriedades

Depth

Obtém um valor que indica a profundidade de aninhamento da linha atual.Gets a value indicating the depth of nesting for the current row.

FieldCount

Quando substituído em uma classe derivada, obtém o número de colunas na linha atual.When overridden in a derived class, gets the number of columns in the current row.

HasRows

Quando substituído em uma classe derivada, obtém um valor que indica se este DbDataReader contém uma ou mais linhas.When overridden in a derived class, gets a value that indicates whether this DbDataReader contains one or more rows.

IsClosed

Quando substituído em uma classe derivada, obtém um valor que indica se o DbDataReader está fechado.When overridden in a derived class, gets a value indicating whether the DbDataReader is closed.

Item[Int32]

Quando substituído em uma classe derivada, obtém o valor da coluna especificada como uma instância de Object.When overridden in a derived class, gets the value of the specified column as an instance of Object.

Item[String]

Quando substituído em uma classe derivada, obtém o valor da coluna especificada como uma instância de Object.When overridden in a derived class, gets the value of the specified column as an instance of 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.When overridden in a derived class, gets the number of rows changed, inserted, or deleted by execution of the SQL statement.

VisibleFieldCount

Obtém o número de campos em DbDataReader que não estão ocultos.Gets the number of fields in the DbDataReader that are not hidden.

Métodos

Close()

Fecha o objeto DbDataReader.Closes the DbDataReader object.

CloseAsync()

Fecha de maneira assíncrona o objeto DbDataReader.Asynchronously closes the DbDataReader object.

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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Herdado de MarshalByRefObject)
Dispose()

Libera todos os recursos usados pela instância atual da classe DbDataReader.Releases all resources used by the current instance of the DbDataReader class.

Dispose(Boolean)

Libera os recursos não gerenciados usados pelo DbDataReader e opcionalmente libera os recursos gerenciados.Releases the unmanaged resources used by the DbDataReader and optionally releases the managed resources.

DisposeAsync()

Libera de forma assíncrona todos os recursos usados pela instância atual da classe DbDataReader.Asynchronously releases all resources used by the current instance of the DbDataReader class.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetBoolean(Int32)

Quando substituído em uma classe derivada, obtém o valor da coluna especificada como um booliano.When overridden in a derived class, gets the value of the specified column as a Boolean.

GetByte(Int32)

Quando substituído em uma classe derivada, obtém o valor da coluna especificada como um byte.When overridden in a derived class, gets the value of the specified column as a 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.When overridden in a derived class, reads a specified number of bytes from the specified column starting at a specified index and writes them to a buffer starting at a specified position in the buffer.

GetChar(Int32)

Quando substituído em uma classe derivada, obtém o valor da coluna especificada como um caractere único.When overridden in a derived class, gets the value of the specified column as a single character.

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.When overridden in a derived class, reads a specified number of characters from a specified column starting at a specified index, and writes them to a buffer starting at a specified position.

GetColumnSchemaAsync(CancellationToken)

Essa é a versão assíncrona de GetColumnSchema(DbDataReader).This is the asynchronous version of GetColumnSchema(DbDataReader). Provedores devem substituir com uma implementação apropriada.Providers should override with an appropriate implementation. Opcionalmente, o cancellationToken pode ser respeitado.The cancellationToken can optionally be honored. A implementação padrão invoca a chamada GetColumnSchema(DbDataReader) síncrona e retorna uma tarefa concluída.The default implementation invokes the synchronous GetColumnSchema(DbDataReader) call and returns a completed task. A implementação padrão retornará uma tarefa cancelada se já tiver passado um cancellationToken cancelado.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Exceções geradas por GetColumnSchema(DbDataReader) serão comunicadas por meio da propriedade Exceção de Tarefa retornada.Exceptions thrown by GetColumnSchema(DbDataReader) will be communicated via the returned Task Exception property.

GetData(Int32)

Retorna um leitor de dados aninhado para a coluna solicitada.Returns a nested data reader for the requested column.

GetDataTypeName(Int32)

Quando substituído em uma classe derivada, obtém o nome do tipo de dados da coluna especificada.When overridden in a derived class, gets name of the data type of the specified column.

GetDateTime(Int32)

Quando substituído em uma classe derivada, obtém o valor da coluna especificada como um objeto DateTime.When overridden in a derived class, gets the value of the specified column as a DateTime object.

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.Returns a DbDataReader object for the requested column ordinal that can be overridden with a provider-specific implementation.

GetDecimal(Int32)

Quando substituído em uma classe derivada, obtém o valor da coluna especificada como um Decimal.When overridden in a derived class, gets the value of the specified column as a 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.When overridden in a derived class, gets the value of the specified column as a double-precision floating point number.

GetEnumerator()

Quando substituído em uma classe derivada, retorna um enumerador que pode ser usado para iterar pelas linhas no leitor de dados.When overridden in a derived class, returns an enumerator that can be used to iterate through the rows in the data reader.

GetFieldType(Int32)

Quando substituído em uma classe derivada, obtém o tipo de dados da coluna especificada.When overridden in a derived class, gets the data type of the specified column.

GetFieldValue<T>(Int32)

Obtém o valor da coluna especificada como um tipo solicitado.Gets the value of the specified column as the requested type.

GetFieldValueAsync<T>(Int32)

Obtém de forma assíncrona o valor da coluna especificada como um tipo solicitado.Asynchronously gets the value of the specified column as the requested type.

GetFieldValueAsync<T>(Int32, CancellationToken)

Obtém de forma assíncrona o valor da coluna especificada como um tipo solicitado.Asynchronously gets the value of the specified column as the requested type.

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.When overridden in a derived class, gets the value of the specified column as a single-precision floating point number.

GetGuid(Int32)

Quando substituído em uma classe derivada, obtém o valor da coluna especificada como um GUID (identificador global exclusivo).When overridden in a derived class, gets the value of the specified column as a globally unique identifier (GUID).

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(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.When overridden in a derived class, gets the value of the specified column as a 16-bit signed integer.

GetInt32(Int32)

Quando substituído em uma classe derivada, obtém o valor da coluna especificada como um inteiro com sinal de 32 bits.When overridden in a derived class, gets the value of the specified column as a 32-bit signed integer.

GetInt64(Int32)

Quando substituído em uma classe derivada, obtém o valor da coluna especificada como um inteiro com sinal de 64 bits.When overridden in a derived class, gets the value of the specified column as a 64-bit signed integer.

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.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(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.When overridden in a derived class, gets the name of the column, given the zero-based column ordinal.

GetOrdinal(String)

Quando substituído em uma classe derivada, obtém o ordinal da coluna dado o nome da coluna.When overridden in a derived class, gets the column ordinal given the name of the column.

GetProviderSpecificFieldType(Int32)

Obtém o tipo específico do provedor da coluna especificada.Gets the provider-specific type of the specified column.

GetProviderSpecificValue(Int32)

Obtém o valor da coluna especificada como uma instância de um tipo específico do provedor.Gets the value of the specified column as an instance of a provider-specific type.

GetProviderSpecificValues(Object[])

Obtém todas as colunas de atributo específicas do provedor na coleção para a linha atual.Gets all provider-specific attribute columns in the collection for the current row.

GetSchemaTable()

Retorna um DataTable que descreve os metadados da coluna do DbDataReader.Returns a DataTable that describes the column metadata of the DbDataReader. Retorna null se o comando executado não retornou nenhum ResultSet ou depois de NextResult() retorna false .Returns null if the executed command returned no resultset, or after NextResult() returns false.

GetSchemaTableAsync(CancellationToken)

Essa é a versão assíncrona de GetSchemaTable().This is the asynchronous version of GetSchemaTable(). Provedores devem substituir com uma implementação apropriada.Providers should override with an appropriate implementation. Opcionalmente, o cancellationToken pode ser respeitado.The cancellationToken can optionally be honored. A implementação padrão invoca a chamada GetSchemaTable() síncrona e retorna uma tarefa concluída.The default implementation invokes the synchronous GetSchemaTable() call and returns a completed task. A implementação padrão retornará uma tarefa cancelada se já tiver passado um cancellationToken cancelado.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Exceções geradas por GetSchemaTable() serão comunicadas por meio da propriedade Exceção de Tarefa retornada.Exceptions thrown by GetSchemaTable() will be communicated via the returned Task Exception property.

GetStream(Int32)

Obtém um fluxo para recuperar dados da coluna especificada.Gets a stream to retrieve data from the specified column.

GetString(Int32)

Quando substituído em uma classe derivada, obtém o valor da coluna especificada como uma instância de String.When overridden in a derived class, gets the value of the specified column as an instance of String.

GetTextReader(Int32)

Obtém um leitor de texto para recuperar dados da coluna.Gets a text reader to retrieve data from the column.

GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(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.When overridden in a derived class, gets the value of the specified column as an instance of Object.

GetValues(Object[])

Quando substituído em uma classe derivada, popula uma matriz de objetos com os valores da coluna da linha atual.When overridden in a derived class, populates an array of objects with the column values of the current row.

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.Obtains a lifetime service object to control the lifetime policy for this instance.

(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.When overridden in a derived class, gets a value that indicates whether the column contains nonexistent or missing values.

IsDBNullAsync(Int32)

Obtém, de maneira assíncrona, um valor que indica se a coluna contém valores ausentes ou inexistente.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

IsDBNullAsync(Int32, CancellationToken)

Obtém, de maneira assíncrona, um valor que indica se a coluna contém valores ausentes ou inexistente.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto MarshalByRefObject atual.Creates a shallow copy of the current MarshalByRefObject object.

(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.When overridden in a derived class, advances the reader to the next result when reading the results of a batch of statements.

NextResultAsync()

Avança de maneira assíncrona o leitor para o resultado seguinte ao ler os resultados de um lote de instruções.Asynchronously advances the reader to the next result when reading the results of a batch of statements.

NextResultAsync(CancellationToken)

Avança de maneira assíncrona o leitor para o resultado seguinte ao ler os resultados de um lote de instruções.Asynchronously advances the reader to the next result when reading the results of a batch of statements.

Read()

Quando substituído em uma classe derivada, avança o leitor para o próximo registro em um conjunto de resultados.When overridden in a derived class, advances the reader to the next record in a result set.

ReadAsync()

Avança de maneira assíncrona o leitor para o próximo registro em um conjunto de resultados.Asynchronously advances the reader to the next record in a result set.

ReadAsync(CancellationToken)

Avança de maneira assíncrona o leitor para o próximo registro em um conjunto de resultados.Asynchronously advances the reader to the next record in a result set.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Implantações explícitas de interface

IDataReader.Close()

Para obter uma descrição desse membro, confira Close().For a description of this member, see Close().

IDataReader.GetSchemaTable()

Para obter uma descrição desse membro, confira GetSchemaTable().For a description of this member, see GetSchemaTable().

IDataRecord.GetData(Int32)

Para obter uma descrição desse membro, confira GetData(Int32).For a description of this member, see GetData(Int32).

Métodos de Extensão

CanGetColumnSchema(DbDataReader)

Obtém um valor que indica se um DbDataReader pode obter um esquema de coluna.Gets a value that indicates whether a DbDataReader can get a column schema.

GetColumnSchema(DbDataReader)

Obtém o esquema da coluna (coleção DbColumn) para um DbDataReader.Gets the column schema (DbColumn collection) for a DbDataReader.

GetBoolean(DbDataReader, String)

Obtém o valor da coluna especificada como um booliano.Gets the value of the specified column as a Boolean.

GetByte(DbDataReader, String)

Obtém o valor da coluna especificada como um byte.Gets the value of the specified column as a 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.Reads a specified number of bytes from the specified column starting at a specified index and writes them to a buffer starting at a specified position in the buffer.

GetChar(DbDataReader, String)

Obtém o valor da coluna especificada como um único caractere.Gets the value of the specified column as a single character.

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.Reads a specified number of characters from a specified column starting at a specified index, and writes them to a buffer starting at a specified position.

GetData(DbDataReader, String)

Retorna um leitor de dados aninhado para a coluna solicitada.Returns a nested data reader for the requested column.

GetDataTypeName(DbDataReader, String)

Obtém o nome do tipo de dados da coluna especificada.Gets name of the data type of the specified column.

GetDateTime(DbDataReader, String)

Obtém o valor da coluna especificada como um objeto DateTime.Gets the value of the specified column as a DateTime object.

GetDecimal(DbDataReader, String)

Obtém o valor da coluna especificada como um Decimal.Gets the value of the specified column as a Decimal.

GetDouble(DbDataReader, String)

Obtém o valor da coluna especificada como um número de ponto flutuante de precisão dupla.Gets the value of the specified column as a double-precision floating point number.

GetFieldType(DbDataReader, String)

Obtém o tipo de dados da coluna especificada.Gets the data type of the specified column.

GetFieldValue<T>(DbDataReader, String)

Obtém o valor da coluna especificada como um tipo solicitado.Gets the value of the specified column as the requested type.

GetFieldValueAsync<T>(DbDataReader, String, CancellationToken)

Obtém de forma assíncrona o valor da coluna especificada como um tipo solicitado.Asynchronously gets the value of the specified column as the requested type.

GetFloat(DbDataReader, String)

Obtém o valor da coluna especificada como um número de ponto flutuante de precisão simples.Gets the value of the specified column as a single-precision floating point number.

GetGuid(DbDataReader, String)

Obtém o valor da coluna especificada como um GUID (identificador global exclusivo).Gets the value of the specified column as a globally unique identifier (GUID).

GetInt16(DbDataReader, String)

Obtém o valor da coluna especificada como um inteiro com sinal de 16 bits.Gets the value of the specified column as a 16-bit signed integer.

GetInt32(DbDataReader, String)

Obtém o valor da coluna especificada como um inteiro com sinal de 32 bits.Gets the value of the specified column as a 32-bit signed integer.

GetInt64(DbDataReader, String)

Obtém o valor da coluna especificada como um inteiro com sinal de 64 bits.Gets the value of the specified column as a 64-bit signed integer.

GetProviderSpecificFieldType(DbDataReader, String)

Obtém o tipo específico do provedor da coluna especificada.Gets the provider-specific type of the specified column.

GetProviderSpecificValue(DbDataReader, String)

Obtém o valor da coluna especificada como uma instância de um tipo específico do provedor.Gets the value of the specified column as an instance of a provider-specific type.

GetStream(DbDataReader, String)

Obtém um fluxo para recuperar dados da coluna especificada.Gets a stream to retrieve data from the specified column.

GetString(DbDataReader, String)

Obtém o valor da coluna especificada como uma instância de String.Gets the value of the specified column as an instance of String.

GetTextReader(DbDataReader, String)

Obtém um leitor de texto para recuperar dados da coluna.Gets a text reader to retrieve data from the column.

GetValue(DbDataReader, String)

Obtém o valor da coluna especificada como uma instância de Object.Gets the value of the specified column as an instance of Object.

IsDBNull(DbDataReader, String)

Obtém um valor que indica se a coluna contém valores ausentes ou inexistentes.Gets a value that indicates whether the column contains nonexistent or missing values.

IsDBNullAsync(DbDataReader, String, CancellationToken)

Obtém, de maneira assíncrona, um valor que indica se a coluna contém valores ausentes ou inexistente.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

Cast<TResult>(IEnumerable)

Converte os elementos de um IEnumerable para o tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base em um tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita a paralelização de uma consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Converte um IEnumerable em um IQueryable.Converts an IEnumerable to an IQueryable.

ConfigureAwait(IAsyncDisposable, Boolean)

Configura como as esperas nas tarefas retornadas de um descartável assíncrono são realizadas.Configures how awaits on the tasks returned from an async disposable are performed.

Aplica-se a