OleDbDataReader Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece uma maneira de ler um fluxo somente de encaminhamento de linhas de dados de uma fonte de dados. Essa classe não pode ser herdada.
public ref class OleDbDataReader sealed : System::Data::Common::DbDataReaderpublic ref class OleDbDataReader sealed : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")]
public sealed class OleDbDataReader : System.Data.Common.DbDataReaderpublic sealed class OleDbDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReaderpublic sealed class OleDbDataReader : System.Data.Common.DbDataReader[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")>]
type OleDbDataReader = class
inherit DbDataReadertype OleDbDataReader = class
inherit MarshalByRefObject
interface IDataReader
interface IDisposable
interface IDataRecord
interface IEnumerabletype OleDbDataReader = class
inherit DbDataReaderPublic NotInheritable Class OleDbDataReader
Inherits DbDataReaderPublic NotInheritable Class OleDbDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerable- Herança
- Herança
- Herança
- Atributos
- Implementações
Exemplos
O exemplo a seguir cria um OleDbConnection, um OleDbCommande um OleDbDataReader. O exemplo lê os dados, gravando-os no console. Por fim, o exemplo fecha e OleDbDataReader , em seguida, o OleDbConnection.
public static void ReadData(string connectionString, string queryString)
{
using (OleDbConnection connection = new OleDbConnection(connectionString))
{
OleDbCommand command = new OleDbCommand(queryString, connection);
connection.Open();
OleDbDataReader reader = command.ExecuteReader();
while (reader.Read())
{
Console.WriteLine(reader[0].ToString());
}
reader.Close();
}
}
Public Sub ReadData(ByVal connectionString As String, _
ByVal queryString As String)
Using connection As New OleDbConnection(connectionString)
Dim command As New OleDbCommand(queryString, connection)
connection.Open()
Dim reader As OleDbDataReader = command.ExecuteReader()
While reader.Read()
Console.WriteLine(reader(0).ToString())
End While
reader.Close()
End Using
End Sub
Comentários
Para criar um OleDbDataReader, você deve chamar o ExecuteReader método do OleDbCommand objeto, em vez de usar diretamente um construtor.
Antes de fechar o OleDbConnectionobjeto, primeiro feche o OleDbDataReader objeto. Você também deve fechar o OleDbDataReader objeto se planeja reutilizar um OleDbCommand objeto. Por exemplo, você não pode recuperar parâmetros de saída até depois de chamar Close.
As alterações feitas em um conjunto de resultados por outro processo ou thread enquanto os dados estão sendo lidos podem estar visíveis para o usuário do OleDbDataReader. No entanto, o comportamento preciso depende do tempo.
IsClosed e RecordsAffected são as únicas propriedades que você pode chamar após o OleDbDataReader fechamento. Embora a RecordsAffected propriedade possa ser acessada enquanto existir OleDbDataReader , sempre chame Close antes de retornar o valor para RecordsAffected garantir um valor retornado preciso.
Propriedades
| Nome | Description |
|---|---|
| Depth |
Obtém um valor que indica a profundidade do aninhamento para a linha atual. |
| FieldCount |
Obtém o número de colunas na linha atual. |
| HasRows |
Obtém um valor que indica se o OleDbDataReader contém uma ou mais linhas. |
| IsClosed |
Indica se o leitor de dados está fechado. |
| Item[Int32] |
Obtém o valor da coluna especificada em seu formato nativo, considerando o ordinal da coluna. |
| Item[String] |
Obtém o valor da coluna especificada em seu formato nativo dado o nome da coluna. |
| RecordsAffected |
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 OleDbDataReader que não estão ocultos. |
Métodos
| Nome | Description |
|---|---|
| Close() |
Fecha o OleDbDataReader objeto. |
| 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 DbDataReader classe. (Herdado de DbDataReader) |
| Dispose(Boolean) |
Libera os recursos não gerenciados usados pelo DbDataReader e, opcionalmente, libera os recursos gerenciados. (Herdado de DbDataReader) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| Finalize() |
Permite que o objeto tente liberar recursos e executar outras operações de limpeza antes de ser recuperado pela coleta de lixo. |
| GetBoolean(Int32) |
Obtém o valor da coluna especificada como um booliano. |
| GetByte(Int32) |
Obtém o valor da coluna especificada como um byte. |
| GetBytes(Int32, Int64, Byte[], Int32, Int32) |
Lê um fluxo de bytes do deslocamento de coluna especificado para o buffer como uma matriz começando no deslocamento de buffer fornecido. |
| GetChar(Int32) |
Obtém o valor da coluna especificada como um caractere. |
| GetChars(Int32, Int64, Char[], Int32, Int32) |
Lê um fluxo de caracteres do deslocamento de coluna especificado para o buffer como uma matriz começando no deslocamento de buffer fornecido. |
| GetData(Int32) |
Retorna um OleDbDataReader objeto para o ordinal de coluna solicitado. |
| GetDataTypeName(Int32) |
Obtém o nome do tipo de dados de origem. |
| GetDateTime(Int32) |
Obtém o valor da coluna especificada como um DateTime objeto. |
| GetDbDataReader(Int32) |
Retorna um DbDataReader objeto para o ordinal de 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 objeto. |
| GetDouble(Int32) |
Obtém o valor da coluna especificada como um número de ponto flutuante de precisão dupla. |
| GetEnumerator() |
Retorna um IEnumerator que pode ser usado para iterar por meio das linhas no leitor de dados. |
| GetFieldType(Int32) |
Obtém o Type tipo de dados do objeto. |
| GetFieldValue<T>(Int32) |
Obtém o valor da coluna especificada como o tipo solicitado. (Herdado de DbDataReader) |
| GetFieldValueAsync<T>(Int32, CancellationToken) |
Obtém de forma assíncrona o valor da coluna especificada como o tipo solicitado. (Herdado de DbDataReader) |
| GetFieldValueAsync<T>(Int32) |
Obtém de forma assíncrona o valor da coluna especificada como o tipo solicitado. (Herdado de DbDataReader) |
| GetFloat(Int32) |
Obtém o valor da coluna especificada como um número de ponto flutuante de precisão única. |
| 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 tempo de vida para essa instância. (Herdado de MarshalByRefObject) |
| GetName(Int32) |
Obtém o nome da coluna especificada. |
| GetOrdinal(String) |
Obtém o ordinal de coluna, dado o nome da coluna. |
| GetProviderSpecificFieldType(Int32) |
Obtém o tipo específico do provedor da coluna especificada. (Herdado de DbDataReader) |
| GetProviderSpecificValue(Int32) |
Obtém o valor da coluna especificada como uma instância de um tipo específico do provedor. (Herdado de DbDataReader) |
| GetProviderSpecificValues(Object[]) |
Obtém todas as colunas de atributo específicas do provedor na coleção da linha atual. (Herdado de DbDataReader) |
| GetSchemaTable() |
Retorna um DataTable que descreve os metadados de coluna do OleDbDataReader. |
| 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) |
| GetTimeSpan(Int32) |
Obtém o valor da coluna especificada como um TimeSpan objeto. |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetValue(Int32) |
Obtém o valor da coluna no ordinal especificado em seu formato nativo. |
| GetValues(Object[]) |
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) |
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. (Herdado de DbDataReader) |
| IsDBNullAsync(Int32) |
Obtém de forma assíncrona um valor que indica se a coluna contém valores inexistentes ou ausentes. (Herdado de DbDataReader) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| MemberwiseClone(Boolean) |
Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject) |
| NextResult() |
Avança o leitor de dados para o próximo resultado ao ler os resultados das instruções SQL do lote. |
| NextResultAsync() |
Avança de forma assíncrona o leitor para o próximo resultado ao ler os resultados de um lote de instruções. (Herdado de DbDataReader) |
| 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. (Herdado de DbDataReader) |
| Read() |
Avança para o OleDbDataReader próximo registro. |
| ReadAsync() |
Avança de forma assíncrona o leitor para o próximo registro em um conjunto de resultados. (Herdado de DbDataReader) |
| ReadAsync(CancellationToken) |
Avança de forma 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
| Nome | Description |
|---|---|
| IDataRecord.GetData(Int32) |
Retorna um IDataReader para o ordinal de coluna especificado. |
| IDataRecord.GetData(Int32) |
Para obter uma descrição deste membro, consulte GetData(Int32). (Herdado de DbDataReader) |
| IDisposable.Dispose() |
Esta API dá suporte à infraestrutura do produto e não deve ser usada diretamente do seu código. Libera os recursos usados pela instância atual da OleDbDataReader classe. |
| IEnumerable.GetEnumerator() |
Retorna um enumerador que itera por meio de uma coleção. |
Métodos de Extensão
| Nome | Description |
|---|---|
| AsParallel(IEnumerable) |
Habilita a paralelização de uma consulta. |
| AsQueryable(IEnumerable) |
Converte um IEnumerable em um IQueryable. |
| CanGetColumnSchema(DbDataReader) |
Obtém um valor que indica se um DbDataReader pode obter um esquema de coluna. |
| Cast<TResult>(IEnumerable) |
Converte os elementos de um IEnumerable para o tipo especificado. |
| GetColumnSchema(DbDataReader) |
Obtém o esquema de coluna (DbColumn coleção) para um DbDataReader. |
| OfType<TResult>(IEnumerable) |
Filtra os elementos de um IEnumerable com base em um tipo especificado. |
