OdbcDataReader 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 por meio de uma fonte de dados. Essa classe não pode ser herdada.
public ref class OdbcDataReader sealed : System::Data::Common::DbDataReader
public ref class OdbcDataReader sealed : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader
public sealed class OdbcDataReader : System.Data.Common.DbDataReader
public sealed class OdbcDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader
type OdbcDataReader = class
inherit DbDataReader
type OdbcDataReader = class
inherit MarshalByRefObject
interface IDataReader
interface IDataRecord
interface IDisposable
interface IEnumerable
Public NotInheritable Class OdbcDataReader
Inherits DbDataReader
Public NotInheritable Class OdbcDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerable
- Herança
- Herança
- Implementações
Exemplos
O exemplo a seguir cria um OdbcConnection, um OdbcCommande um OdbcDataReader. O exemplo lê os dados, gravando-os no console. Por fim, o exemplo fecha o OdbcDataReadere, em seguida, o OdbcConnection.
public static void ReadData(string connectionString)
{
string queryString = "SELECT DISTINCT CustomerID FROM Orders";
using (OdbcConnection connection = new OdbcConnection(connectionString))
{
OdbcCommand command = new OdbcCommand(queryString, connection);
connection.Open();
// Execute the DataReader and access the data.
OdbcDataReader reader = command.ExecuteReader();
while (reader.Read())
{
Console.WriteLine("CustomerID={0}", reader[0]);
}
// Call Close when done reading.
reader.Close();
}
}
Public Sub ReadData(ByVal connectionString As String)
Dim queryString As String = "SELECT DISTINCT CustomerID FROM Orders"
Using connection As New OdbcConnection(connectionString)
Dim command As New OdbcCommand(queryString, connection)
connection.Open()
Dim reader As OdbcDataReader = command.ExecuteReader()
While reader.Read()
Console.WriteLine("CustomerID={0}", reader(0).ToString)
End While
' Call Close when done reading.
reader.Close()
End Using
End Sub
Comentários
Para criar um OdbcDataReader, você deve chamar o ExecuteReader método do OdbcCommand objeto, em vez de usar diretamente um construtor.
Enquanto o OdbcDataReader está sendo usado, o associado OdbcConnection está ocupado atendendo ao OdbcDataReadere nenhuma outra operação pode ser executada no outro que não seja OdbcConnection fechá-lo. Esse é o caso até que o Close método do OdbcDataReader seja chamado. 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 dados estão sendo lidos podem ser visíveis para o usuário do OdbcDataReader. No entanto, o comportamento preciso depende do driver e do tempo.
IsClosed e RecordsAffected são as únicas propriedades que podem ser chamadas depois que o OdbcDataReader for fechado. Às vezes, você deve chamar Close antes de chamar RecordsAffected.
Propriedades
Depth |
Obtém um valor que indica a profundidade de aninhamento da linha atual. |
FieldCount |
Obtém o número de colunas na linha atual. |
HasRows |
Obtém um valor que indica se o OdbcDataReader contém uma ou mais linhas. |
IsClosed |
Indica se o OdbcDataReader está fechado. |
Item[Int32] |
Obtém o valor da coluna especificada em seu formato nativo de acordo com o ordinal da coluna. |
Item[String] |
Obtém o valor da coluna especificada em seu formato nativo de acordo com 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 em DbDataReader que não estão ocultos. (Herdado de DbDataReader) |
Métodos
Close() |
Fecha o objeto OdbcDataReader. |
CloseAsync() |
Fecha de maneira assíncrona o objeto DbDataReader. (Herdado de 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. (Herdado de DbDataReader) |
Dispose(Boolean) |
Libera os recursos não gerenciados usados pelo DbDataReader e opcionalmente libera os recursos gerenciados. (Herdado de DbDataReader) |
DisposeAsync() |
Libera de forma assíncrona todos os recursos usados pela instância atual da classe DbDataReader. (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 no buffer como uma matriz, iniciando no deslocamento de buffer em particular. |
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 no buffer como uma matriz, iniciando no deslocamento de buffer em particular. |
GetColumnSchemaAsync(CancellationToken) |
Essa é a versão assíncrona de GetColumnSchema(DbDataReader).
Provedores devem substituir com uma implementação apropriada.
Opcionalmente, o |
GetData(Int32) |
Retorna um IDataReader para o ordinal da coluna especificada. |
GetData(Int32) |
Retorna um leitor de dados aninhado para a coluna solicitada. (Herdado de DbDataReader) |
GetDataTypeName(Int32) |
Obtém o nome do tipo de dados de origem. |
GetDate(Int32) |
Obtém o valor da coluna especificada como um objeto DateTime. |
GetDateTime(Int32) |
Obtém o valor da coluna especificada como um objeto DateTime. |
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. (Herdado de DbDataReader) |
GetDecimal(Int32) |
Obtém o valor da coluna especificada como um objeto Decimal. |
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 pelas linhas do leitor de dados. |
GetFieldType(Int32) |
Obtém o Type que é o tipo de dados do objeto. |
GetFieldValue<T>(Int32) |
Obtém o valor da coluna especificada como um tipo solicitado. (Herdado de DbDataReader) |
GetFieldValueAsync<T>(Int32) |
Obtém de forma assíncrona o valor da coluna especificada como um tipo solicitado. (Herdado de DbDataReader) |
GetFieldValueAsync<T>(Int32, CancellationToken) |
Obtém de forma assíncrona o valor da coluna especificada como um 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 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 ciclo de vida para esta instância. (Herdado de MarshalByRefObject) |
GetName(Int32) |
Obtém o nome da coluna especificada. |
GetOrdinal(String) |
Obtém a ordinal da coluna, de acordo com 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 para a linha atual. (Herdado de DbDataReader) |
GetSchemaTable() |
Retorna um DataTable que descreve os metadados da coluna do OdbcDataReader. |
GetSchemaTableAsync(CancellationToken) |
Essa é a versão assíncrona de GetSchemaTable().
Provedores devem substituir com uma implementação apropriada.
Opcionalmente, o |
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 um String. |
GetTextReader(Int32) |
Obtém um leitor de texto para recuperar dados da coluna. (Herdado de DbDataReader) |
GetTime(Int32) |
Obtém o valor da coluna especificada como um 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 em seu formato nativo. |
GetValues(Object[]) |
Popula uma matriz de objetos com os valores da 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 para essa instância. (Herdado de MarshalByRefObject) |
IsDBNull(Int32) |
Obtém um valor que indica se a coluna contém valores ausentes ou inexistentes. |
IsDBNullAsync(Int32) |
Obtém, de maneira assíncrona, um valor que indica se a coluna contém valores ausentes ou inexistente. (Herdado de DbDataReader) |
IsDBNullAsync(Int32, CancellationToken) |
Obtém, de maneira assíncrona, um valor que indica se a coluna contém valores ausentes ou inexistente. (Herdado de DbDataReader) |
MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
MemberwiseClone(Boolean) |
Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject) |
NextResult() |
Leva o OdbcDataReader ao resultado seguinte ao ler os resultados de instruções SQL em lote. |
NextResultAsync() |
Avança de maneira assíncrona o leitor para o resultado seguinte ao ler os resultados de um lote de instruções. (Herdado de DbDataReader) |
NextResultAsync(CancellationToken) |
Avança de maneira assíncrona o leitor para o resultado seguinte ao ler os resultados de um lote de instruções. (Herdado de DbDataReader) |
Read() |
Avança o OdbcDataReader para o próximo registro. |
ReadAsync() |
Avança de maneira assíncrona o leitor para o próximo registro em um conjunto de resultados. (Herdado de DbDataReader) |
ReadAsync(CancellationToken) |
Avança de maneira 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
IDataRecord.GetData(Int32) |
Para obter uma descrição desse membro, confira 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 todos os recursos usados pela instância atual da classe OdbcDataReader. |
IEnumerable.GetEnumerator() |
Esta API dá suporte à infraestrutura do produto e não deve ser usada diretamente do seu código. Retorna um enumerador que itera em uma coleção. |
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 da coluna (coleção DbColumn) 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 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. |
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 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. |
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 um tipo solicitado. |
GetFieldValueAsync<T>(DbDataReader, String, CancellationToken) |
Obtém de forma assíncrona o valor da coluna especificada como um tipo solicitado. |
GetFloat(DbDataReader, String) |
Obtém o valor da coluna especificada como um número de ponto flutuante de precisão simples. |
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 ausentes ou inexistentes. |
IsDBNullAsync(DbDataReader, String, CancellationToken) |
Obtém, de maneira assíncrona, um valor que indica se a coluna contém valores ausentes ou inexistente. |
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 são realizadas. |
Aplica-se a
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de