DbDataReader DbDataReader DbDataReader DbDataReader Class

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 : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader
public abstract class DbDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader
type DbDataReader = class
    inherit MarshalByRefObject
    interface IDataReader
    interface IEnumerable
    interface IDisposable
    interface IDataRecord
Public MustInherit Class DbDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerable
Herança
Derivado
Implementações

Construtores

DbDataReader() DbDataReader() DbDataReader() DbDataReader()

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

Propriedades

Depth Depth Depth 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 FieldCount FieldCount FieldCount

Obtém o número de colunas na linha atual. Gets the number of columns in the current row.

HasRows HasRows HasRows HasRows

Obtém um valor que indica se este DbDataReader contém uma ou mais linhas. Gets a value that indicates whether this DbDataReader contains one or more rows.

IsClosed IsClosed IsClosed IsClosed

Obtém um valor que indica se o DbDataReader está fechado. Gets a value indicating whether the DbDataReader is closed.

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

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.

Item[String] Item[String] Item[String] Item[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.

RecordsAffected RecordsAffected RecordsAffected RecordsAffected

Obtém o número de linhas alteradas, inseridas ou excluídas pela execução da instrução SQL. Gets the number of rows changed, inserted, or deleted by execution of the SQL statement.

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

Fecha o objeto DbDataReader. Closes the DbDataReader object.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) 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.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() 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) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

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

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetBoolean(Int32) GetBoolean(Int32) GetBoolean(Int32) GetBoolean(Int32)

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

GetByte(Int32) GetByte(Int32) GetByte(Int32) GetByte(Int32)

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

GetBytes(Int32, Int64, Byte[], Int32, Int32) GetBytes(Int32, Int64, Byte[], Int32, Int32) GetBytes(Int32, Int64, Byte[], Int32, Int32) GetBytes(Int32, Int64, Byte[], Int32, Int32)

Lê um fluxo de bytes na coluna especificada, iniciando no local indicado por dataOffset, no buffer, iniciando na posição indicada por bufferOffset. Reads a stream of bytes from the specified column, starting at location indicated by dataOffset, into the buffer, starting at the location indicated by bufferOffset.

GetChar(Int32) GetChar(Int32) GetChar(Int32) GetChar(Int32)

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

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

Lê um fluxo de caracteres na coluna especificada, iniciando no local indicado por dataOffset, no buffer, iniciando na posição indicada por bufferOffset. Reads a stream of characters from the specified column, starting at location indicated by dataOffset, into the buffer, starting at the location indicated by bufferOffset.

GetData(Int32) GetData(Int32) GetData(Int32) GetData(Int32)

Retorna um objeto DbDataReader para o ordinal da coluna solicitado. Returns a DbDataReader object for the requested column ordinal.

GetDataTypeName(Int32) GetDataTypeName(Int32) GetDataTypeName(Int32) GetDataTypeName(Int32)

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

GetDateTime(Int32) GetDateTime(Int32) GetDateTime(Int32) GetDateTime(Int32)

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

GetDbDataReader(Int32) GetDbDataReader(Int32) GetDbDataReader(Int32) 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) GetDecimal(Int32) GetDecimal(Int32) GetDecimal(Int32)

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

GetDouble(Int32) GetDouble(Int32) GetDouble(Int32) GetDouble(Int32)

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.

GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Retorna um IEnumerator que pode ser usado para iterar pelas linhas do leitor de dados. Returns an IEnumerator that can be used to iterate through the rows in the data reader.

GetFieldType(Int32) GetFieldType(Int32) GetFieldType(Int32) GetFieldType(Int32)

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

GetFieldValue<T>(Int32) GetFieldValue<T>(Int32) GetFieldValue<T>(Int32) GetFieldValue<T>(Int32)

Obtém de forma síncrona o valor da coluna especificada como um tipo. Synchronously gets the value of the specified column as a type.

GetFieldValueAsync<T>(Int32) GetFieldValueAsync<T>(Int32) GetFieldValueAsync<T>(Int32) GetFieldValueAsync<T>(Int32)

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

GetFieldValueAsync<T>(Int32, CancellationToken) GetFieldValueAsync<T>(Int32, CancellationToken) GetFieldValueAsync<T>(Int32, CancellationToken) GetFieldValueAsync<T>(Int32, CancellationToken)

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

GetFloat(Int32) GetFloat(Int32) GetFloat(Int32) GetFloat(Int32)

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

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

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetInt16(Int32) GetInt16(Int32) GetInt16(Int32) GetInt16(Int32)

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

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

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.

GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

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.

(Inherited from MarshalByRefObject)
GetName(Int32) GetName(Int32) GetName(Int32) GetName(Int32)

Obtém o nome da coluna, dado o ordinal da coluna com base em zero. Gets the name of the column, given the zero-based column ordinal.

GetOrdinal(String) GetOrdinal(String) GetOrdinal(String) GetOrdinal(String)

Obtém o ordinal da coluna, de acordo com o nome da coluna. Gets the column ordinal given the name of the column.

GetProviderSpecificFieldType(Int32) GetProviderSpecificFieldType(Int32) GetProviderSpecificFieldType(Int32) GetProviderSpecificFieldType(Int32)

Retorna o tipo de campo específico do provedor da coluna especificada. Returns the provider-specific field type of the specified column.

GetProviderSpecificValue(Int32) GetProviderSpecificValue(Int32) GetProviderSpecificValue(Int32) GetProviderSpecificValue(Int32)

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.

GetProviderSpecificValues(Object[]) GetProviderSpecificValues(Object[]) GetProviderSpecificValues(Object[]) 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() GetSchemaTable() GetSchemaTable() GetSchemaTable()

Retorna um DataTable que descreve os metadados da coluna do DbDataReader. Returns a DataTable that describes the column metadata of the DbDataReader.

GetStream(Int32) GetStream(Int32) GetStream(Int32) GetStream(Int32)

Recupera os dados como um Stream. Retrieves data as a Stream.

GetString(Int32) GetString(Int32) GetString(Int32) GetString(Int32)

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

Recupera os dados como um TextReader. Retrieves data as a TextReader.

GetType() GetType() GetType() GetType()

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

(Inherited from Object)
GetValue(Int32) GetValue(Int32) GetValue(Int32) GetValue(Int32)

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.

GetValues(Object[]) GetValues(Object[]) GetValues(Object[]) GetValues(Object[])

Popula uma matriz de objetos com os valores da coluna da linha atual. Populates an array of objects with the column values of the current row.

InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

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.

(Inherited from MarshalByRefObject)
IsDBNull(Int32) IsDBNull(Int32) IsDBNull(Int32) IsDBNull(Int32)

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

Uma versão assíncrona de IsDBNull(Int32), que obtém um valor que indica se a coluna contém valores ausentes ou inexistente. An asynchronous version of IsDBNull(Int32), which gets a value that indicates whether the column contains non-existent or missing values.

IsDBNullAsync(Int32, CancellationToken) IsDBNullAsync(Int32, CancellationToken) IsDBNullAsync(Int32, CancellationToken) IsDBNullAsync(Int32, CancellationToken)

Uma versão assíncrona de IsDBNull(Int32), que obtém um valor que indica se a coluna contém valores ausentes ou inexistente. An asynchronous version of IsDBNull(Int32), which gets a value that indicates whether the column contains non-existent or missing values. Opcionalmente, envia uma notificação de que as operações devem ser canceladas. Optionally, sends a notification that operations should be cancelled.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

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

(Inherited from MarshalByRefObject)
NextResult() NextResult() NextResult() NextResult()

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

NextResultAsync() NextResultAsync() NextResultAsync() NextResultAsync()

Uma versão assíncrona de NextResult(), que avança o leitor para o resultado seguinte ao ler os resultados de um lote de instruções. An asynchronous version of NextResult(), which advances the reader to the next result when reading the results of a batch of statements. Invoca NextResultAsync(CancellationToken) com CancellationToken.None. Invokes NextResultAsync(CancellationToken) with CancellationToken.None.

NextResultAsync(CancellationToken) NextResultAsync(CancellationToken) NextResultAsync(CancellationToken) NextResultAsync(CancellationToken)

Essa é a versão assíncrona de NextResult(). This is the asynchronous version of NextResult(). Provedores devem substituir com uma implementação apropriada. Providers should override with an appropriate implementation. O cancellationToken opcionalmente pode ser ignorado. The cancellationToken may optionally be ignored. A implementação padrão invoca o método NextResult() síncrono e retorna uma tarefa concluída, bloqueando o thread de chamada. The default implementation invokes the synchronous NextResult() method and returns a completed task, blocking the calling thread. 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 NextResult() serão comunicadas por meio da propriedade Exceção de Tarefa retornada. Exceptions thrown by NextResult() will be communicated via the returned Task Exception property. Outros métodos e propriedades do objeto DbDataReader não devem ser chamados enquanto a Tarefa retornada ainda não tiver sido concluída. Other methods and properties of the DbDataReader object should not be invoked while the returned Task is not yet completed.

Read() Read() Read() Read()

Avança o leitor para o próximo registro em um conjunto de resultados. Advances the reader to the next record in a result set.

ReadAsync() ReadAsync() ReadAsync() ReadAsync()

Uma versão assíncrona de Read(), que avança o leitor para o próximo registro em um conjunto de resultados. An asynchronous version of Read(), which advances the reader to the next record in a result set. Esse método invoca o ReadAsync(CancellationToken) com CancellationToken.None. This method invokes ReadAsync(CancellationToken) with CancellationToken.None.

ReadAsync(CancellationToken) ReadAsync(CancellationToken) ReadAsync(CancellationToken) ReadAsync(CancellationToken)

Essa é a versão assíncrona de Read(). This is the asynchronous version of Read(). Provedores devem substituir com uma implementação apropriada. Providers should override with an appropriate implementation. Opcionalmente, o cancellationToken pode ser ignorado. The cancellationToken may optionally be ignored. A implementação padrão invoca o método Read() síncrono e retorna uma tarefa concluída, bloqueando o thread de chamada. The default implementation invokes the synchronous Read() method and returns a completed task, blocking the calling thread. 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 Read serão comunicadas por meio da propriedade Exceção de Tarefa retornada. Exceptions thrown by Read will be communicated via the returned Task Exception property. Não invoque outros métodos e propriedades do objeto DbDataReader até a Tarefa retornada ser concluída. Do not invoke other methods and properties of the DbDataReader object until the returned Task is complete.

ToString() ToString() ToString() ToString()

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

(Inherited from Object)

Implantações explícitas de interface

IDataReader.Close() IDataReader.Close() IDataReader.Close() IDataReader.Close()
IDataReader.GetSchemaTable() IDataReader.GetSchemaTable() IDataReader.GetSchemaTable() IDataReader.GetSchemaTable()
IDataRecord.GetData(Int32) IDataRecord.GetData(Int32) IDataRecord.GetData(Int32) IDataRecord.GetData(Int32)

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

Aplica-se a

Veja também