OleDbDataReader Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Fornece uma forma de ler um fluxo apenas direto de linhas de dados de uma fonte de dados. Esta classe não pode ser herdada.
public ref class OleDbDataReader sealed : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReaderpublic ref class OleDbDataReader sealed : System::Data::Common::DbDataReaderpublic sealed class OleDbDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReaderpublic sealed class OleDbDataReader : System.Data.Common.DbDataReadertype OleDbDataReader = class
inherit MarshalByRefObject
interface IDataReader
interface IDisposable
interface IDataRecord
interface IEnumerabletype OleDbDataReader = class
inherit DbDataReaderPublic NotInheritable Class OleDbDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerablePublic NotInheritable Class OleDbDataReader
Inherits DbDataReader- Herança
- Herança
- Implementações
Exemplos
O exemplo seguinte cria um OleDbConnection, um OleDbCommand, e um OleDbDataReader. O exemplo lê os dados, escrevendo-os para a consola. Finalmente, o exemplo fecha o OleDbDataReader e depois 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
Observações
Para criar um OleDbDataReader, deve chamar o ExecuteReader método do OleDbCommand objeto, em vez de usar diretamente um construtor.
Antes de fechar o OleDbConnection, primeiro feche o OleDbDataReader objeto. Também deve fechar o OleDbDataReader objeto se planear reutilizar um OleDbCommand objeto. Por exemplo, não pode recuperar parâmetros de saída até depois de chamar Close.
Alterações feitas a um conjunto de resultados por outro processo ou thread enquanto os dados estão a ser lidos podem ser visíveis para o utilizador do OleDbDataReader. No entanto, o comportamento exato depende do timing.
IsClosed e RecordsAffected são as únicas propriedades que pode chamar depois de o OleDbDataReader fechar. Embora a RecordsAffected propriedade possa ser acedida enquanto existe, OleDbDataReader ligue Close sempre antes de devolver o valor de RecordsAffected para garantir um valor de retorno preciso.
Propriedades
| Name | Description |
|---|---|
| Depth |
Obtém um valor que indica a profundidade de aninhamento para a linha atual. |
| FieldCount |
Obtém o número de colunas na linha atual. |
| HasRows |
Obtém um valor que indica se contém OleDbDataReader uma ou mais linhas. |
| IsClosed |
Indica se o leitor de dados está fechado. |
| Item[Int32] |
Obtém o valor da coluna especificada no seu formato nativo dado o ordinal da coluna. |
| Item[String] |
Obtém o valor da coluna especificada no seu formato nativo, dado o nome da coluna. |
| RecordsAffected |
Faz com que o número de linhas seja alterado, inserido ou eliminado 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
| Name | Description |
|---|---|
| Close() |
Fecha o OleDbDataReader objeto. |
| CreateObjRef(Type) |
Cria um objeto que contém toda a informação relevante necessária para gerar um proxy usado para comunicar com um objeto remoto. (Herdado de MarshalByRefObject) |
| Dispose() |
Liberta todos os recursos usados pela instância atual da DbDataReader classe. (Herdado de DbDataReader) |
| Dispose(Boolean) |
Liberta os recursos não geridos usados pelo DbDataReader e opcionalmente liberta os recursos geridos. (Herdado de DbDataReader) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| Finalize() |
Permite que o objeto tente libertar recursos e realizar outras operações de limpeza antes de ser recuperado pela recolha de lixo. |
| GetBoolean(Int32) |
Obtém o valor da coluna especificada como um Booleano. |
| 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 um array a partir do deslocamento do buffer dado. |
| GetChar(Int32) |
Obtém o valor da coluna especificada como um carácter. |
| GetChars(Int32, Int64, Char[], Int32, Int32) |
Lê um fluxo de caracteres do deslocamento de coluna especificado para o buffer como um array a partir do deslocamento do buffer dado. |
| GetData(Int32) |
Devolve um OleDbDataReader objeto para o ordinal da coluna solicitada. |
| GetDataTypeName(Int32) |
Obtém o nome do tipo de dados de origem. |
| GetDateTime(Int32) |
Obtém o valor da coluna especificada como objeto DateTime . |
| GetDbDataReader(Int32) |
Devolve um DbDataReader objeto para o ordinal da coluna solicitado que pode ser sobreposto com uma implementação específica do fornecedor. (Herdado de DbDataReader) |
| GetDecimal(Int32) |
Obtém o valor da coluna especificada como objeto Decimal . |
| GetDouble(Int32) |
Obtém o valor da coluna especificada como um número de ponto flutuante de dupla precisão. |
| GetEnumerator() |
Retorna e IEnumerator que pode ser usado para iterar pelas linhas no leitor de dados. |
| GetFieldType(Int32) |
Obtém-se que Type é o tipo de dado do objeto. |
| GetFieldValue<T>(Int32) |
Recebe o valor da coluna especificada como o tipo solicitado. (Herdado de DbDataReader) |
| GetFieldValueAsync<T>(Int32, CancellationToken) |
Assíncrono, obtém o valor da coluna especificada como o tipo solicitado. (Herdado de DbDataReader) |
| GetFieldValueAsync<T>(Int32) |
Assíncrono, obtém 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 simples. |
| GetGuid(Int32) |
Obtém o valor da coluna especificada como um identificador globalmente único (GUID). |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetInt16(Int32) |
Obtém o valor da coluna especificada como um inteiro com assinatura de 16 bits. |
| GetInt32(Int32) |
Obtém o valor da coluna especificada como um inteiro assinado de 32 bits. |
| GetInt64(Int32) |
Obtém o valor da coluna especificada como um inteiro assinado de 64 bits. |
| GetLifetimeService() |
Recupera o objeto de serviço de tempo de vida atual que controla a política de vida útil neste caso. (Herdado de MarshalByRefObject) |
| GetName(Int32) |
Obtém o nome da coluna especificada. |
| GetOrdinal(String) |
Obtém o ordinal da coluna, dado o nome da coluna. |
| GetProviderSpecificFieldType(Int32) |
Obtém o tipo específico do fornecedor da coluna especificada. (Herdado de DbDataReader) |
| GetProviderSpecificValue(Int32) |
Obtém o valor da coluna especificada como uma instância de um tipo específico de fornecedor. (Herdado de DbDataReader) |
| GetProviderSpecificValues(Object[]) |
Obtém todas as colunas de atributos específicas do fornecedor na coleção para a linha atual. (Herdado de DbDataReader) |
| GetSchemaTable() |
Devolve um DataTable que descreve os metadados OleDbDataReaderda coluna de . |
| GetStream(Int32) |
Recebe um fluxo para recuperar dados da coluna especificada. (Herdado de DbDataReader) |
| GetString(Int32) |
Obtém o valor da coluna especificada como uma cadeia. |
| GetTextReader(Int32) |
Faz com que um leitor de texto recupere dados da coluna. (Herdado de DbDataReader) |
| GetTimeSpan(Int32) |
Obtém o valor da coluna especificada como objeto TimeSpan . |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetValue(Int32) |
Obtém o valor da coluna no ordinal especificado no seu formato nativo. |
| GetValues(Object[]) |
Preenche um array de objetos com os valores das colunas da linha atual. |
| InitializeLifetimeService() |
Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso. (Herdado de MarshalByRefObject) |
| IsDBNull(Int32) |
Recebe um valor que indica se a coluna contém valores inexistentes ou em falta. |
| IsDBNullAsync(Int32, CancellationToken) |
De forma assíncrona, obtém um valor que indica se a coluna contém valores inexistentes ou em falta. (Herdado de DbDataReader) |
| IsDBNullAsync(Int32) |
De forma assíncrona, obtém um valor que indica se a coluna contém valores inexistentes ou em falta. (Herdado de DbDataReader) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (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 resultado seguinte, ao ler os resultados das instruções SQL em lote. |
| NextResultAsync() |
De forma assíncrona, avança o leitor para o resultado seguinte ao ler os resultados de um conjunto de instruções. (Herdado de DbDataReader) |
| NextResultAsync(CancellationToken) |
De forma assíncrona, avança o leitor para o resultado seguinte ao ler os resultados de um conjunto de instruções. (Herdado de DbDataReader) |
| Read() |
Avança OleDbDataReader para o próximo disco. |
| ReadAsync() |
De forma assíncrona, avança o leitor para o registo seguinte num conjunto de resultados. (Herdado de DbDataReader) |
| ReadAsync(CancellationToken) |
De forma assíncrona, avança o leitor para o registo seguinte num conjunto de resultados. (Herdado de DbDataReader) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
Implementações de Interface Explícita
| Name | Description |
|---|---|
| IDataRecord.GetData(Int32) |
Devolve um IDataReader para o ordinal da coluna especificado. |
| IDataRecord.GetData(Int32) |
Para uma descrição deste elemento, veja GetData(Int32). (Herdado de DbDataReader) |
| IDisposable.Dispose() |
Esta API suporta a infraestrutura de produtos e não é pressuposta para ser utilizada diretamente a partir do seu código. Liberta os recursos usados pela instância atual da OleDbDataReader classe. |
| IEnumerable.GetEnumerator() |
Devolve um enumerador que itera numa coleção. |
Métodos da Extensão
| Name | Description |
|---|---|
| AsParallel(IEnumerable) |
Permite a paralelização de uma consulta. |
| AsQueryable(IEnumerable) |
Converte um IEnumerable para um IQueryable. |
| CanGetColumnSchema(DbDataReader) |
Obtém um valor que indica se um DbDataReader pode obter um esquema de coluna. |
| Cast<TResult>(IEnumerable) |
Conjura os elementos de an IEnumerable para o tipo especificado. |
| GetColumnSchema(DbDataReader) |
Obtém o esquema de colunas (DbColumn coleção) para um DbDataReader. |
| OfType<TResult>(IEnumerable) |
Filtra os elementos de um IEnumerable com base num tipo especificado. |