OdbcDataReader Classe

Definizione

Fornisce un modo per leggere un flusso di righe di dati forward-only da un'origine dati. La classe non può essere ereditata.

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
Ereditarietà
OdbcDataReader
Ereditarietà
Ereditarietà
OdbcDataReader
Implementazioni

Esempio

Nell'esempio seguente viene creato un OdbcConnectionoggetto , un OdbcCommandoggetto e un oggetto OdbcDataReader. L'esempio legge i dati, scrivendoli nella console. Infine, l'esempio chiude , OdbcDataReadere quindi .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

Commenti

Per creare un OdbcDataReaderoggetto , è necessario chiamare il ExecuteReader metodo dell'oggetto OdbcCommand anziché usare direttamente un costruttore.

Durante l'utilizzo OdbcDataReader di , l'oggetto associato OdbcConnection è occupato a gestire OdbcDataReadere non è possibile eseguire altre operazioni sull'oggetto OdbcConnection diverso da chiuderlo. Questo è il caso fino a quando non viene chiamato il Close metodo di OdbcDataReader . Ad esempio, non è possibile recuperare i parametri di output fino a quando non si chiama Close.

Le modifiche apportate a un set di risultati da un altro processo o thread durante la lettura dei dati possono essere visibili all'utente dell'oggetto OdbcDataReader. Tuttavia, il comportamento preciso dipende sia dal driver che dal temporizzazione.

IsClosed e RecordsAffected sono le uniche proprietà che possono essere chiamate dopo la chiusura dell'oggetto OdbcDataReader. In alcuni casi, è necessario chiamare prima di poter chiamare CloseRecordsAffected.

Proprietà

Depth

Ottiene un valore che indica la profondità dell'annidamento per la riga corrente.

FieldCount

Ottiene il numero di colonne nella riga corrente.

HasRows

Ottiene un valore che indica se la classe OdbcDataReader contiene una o più righe.

IsClosed

Indica se la classe OdbcDataReader è chiusa.

Item[Int32]

Ottiene il valore della colonna specificata nel formato nativo, data la posizione ordinale della colonna.

Item[String]

Ottiene il valore della colonna specificata nel formato nativo, dato il nome della colonna.

RecordsAffected

Ottiene il numero di righe modificate, inserite o eliminate dall'esecuzione dell'istruzione SQL.

VisibleFieldCount

Ottiene il numero di campi non nascosti in DbDataReader.

(Ereditato da DbDataReader)

Metodi

Close()

Chiude l'oggetto OdbcDataReader.

CloseAsync()

Chiude in modo asincrono l'oggetto DbDataReader.

(Ereditato da DbDataReader)
CreateObjRef(Type)

Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto.

(Ereditato da MarshalByRefObject)
Dispose()

Rilascia tutte le risorse usate dall'istanza corrente della classe DbDataReader.

(Ereditato da DbDataReader)
Dispose(Boolean)

Rilascia le risorse non gestite usate da DbDataReader e, facoltativamente, le risorse gestite.

(Ereditato da DbDataReader)
DisposeAsync()

Rilascia in modo asincrono le risorse usate dall'istanza corrente della classe DbDataReader.

(Ereditato da DbDataReader)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
Finalize()

Consente all'oggetto di provare a liberare risorse ed eseguire altre operazioni di pulizia prima che l'oggetto stesso venga recuperato da Garbage Collection.

GetBoolean(Int32)

Ottiene il valore della colonna specificata come valore Boolean.

GetByte(Int32)

Ottiene il valore della colonna specificata come byte.

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

Legge un flusso di byte dall'offset della colonna specificata nel buffer come una matrice, a partire dall'offset del buffer specificato.

GetChar(Int32)

Ottiene il valore della colonna specificata sotto forma di carattere.

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

Legge un flusso di caratteri dall'offset della colonna specificata nel buffer come una matrice, a partire dall'offset del buffer specificato.

GetColumnSchemaAsync(CancellationToken)

Si tratta della versione asincrona di GetColumnSchema(DbDataReader). I provider devono eseguire l'override con un'implementazione appropriata. cancellationToken può facoltativamente essere rispettato. L'implementazione predefinita richiama la chiamata sincrona GetColumnSchema(DbDataReader) e restituisce un'attività completata. L'implementazione predefinita restituirà un'attività annullata se viene passato un cancellationToken già annullato. Le eccezioni generate da GetColumnSchema(DbDataReader) verranno passate mediante la proprietà Task Exception restituita.

(Ereditato da DbDataReader)
GetData(Int32)

Restituisce IDataReader per l'ordinale di colonna specificato.

GetData(Int32)

Restituisce un lettore di dati annidati per la colonna richiesta.

(Ereditato da DbDataReader)
GetDataTypeName(Int32)

Ottiene il nome del tipo di dati di origine.

GetDate(Int32)

Ottiene il valore della colonna specificata come oggetto DateTime.

GetDateTime(Int32)

Ottiene il valore della colonna specificata come oggetto DateTime.

GetDbDataReader(Int32)

Restituisce un oggetto DbDataReader per l'ordinale di colonna richiesto, di cui è possibile eseguire l'override tramite un'implementazione specifica del provider.

(Ereditato da DbDataReader)
GetDecimal(Int32)

Ottiene il valore della colonna specificata come oggetto Decimal.

GetDouble(Int32)

Ottiene il valore della colonna specificata sotto forma di numero a virgola mobile e precisione doppia.

GetEnumerator()

Restituisce un oggetto IEnumerator che può essere utilizzato per scorrere le righe nel lettore di dati.

GetFieldType(Int32)

Ottiene l'oggetto Type che rappresenta il tipo di dati dell'oggetto.

GetFieldValue<T>(Int32)

Ottiene il valore della colonna specificata come tipo richiesto.

(Ereditato da DbDataReader)
GetFieldValueAsync<T>(Int32)

Ottiene in modo asincrono il valore della colonna specificata come tipo richiesto.

(Ereditato da DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken)

Ottiene in modo asincrono il valore della colonna specificata come tipo richiesto.

(Ereditato da DbDataReader)
GetFloat(Int32)

Ottiene il valore della colonna specificata sotto forma di numero in virgola mobile e precisione singola.

GetGuid(Int32)

Ottiene il valore della colonna specificata come identificatore univoco globale (GUID).

GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetInt16(Int32)

Ottiene il valore della colonna specificata sotto forma di intero con segno a 16 bit.

GetInt32(Int32)

Ottiene il valore della colonna specificata come intero con segno a 32 bit.

GetInt64(Int32)

Ottiene il valore della colonna specificata come integer con segno a 64 bit.

GetLifetimeService()
Obsoleti.

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.

(Ereditato da MarshalByRefObject)
GetName(Int32)

Ottiene il nome della colonna specificata.

GetOrdinal(String)

Ottiene la posizione ordinale della colonna, dato il nome della colonna.

GetProviderSpecificFieldType(Int32)

Restituisce il tipo specifico del provider per la colonna indicata.

(Ereditato da DbDataReader)
GetProviderSpecificValue(Int32)

Ottiene il valore della colonna specificata come istanza di un tipo specifico del provider.

(Ereditato da DbDataReader)
GetProviderSpecificValues(Object[])

Ottiene tutte le colonne attributo specifiche del provider nella raccolta per la riga corrente.

(Ereditato da DbDataReader)
GetSchemaTable()

Restituisce un oggetto DataTable che descrive i metadati della colonna di OdbcDataReader.

GetSchemaTableAsync(CancellationToken)

Si tratta della versione asincrona di GetSchemaTable(). I provider devono eseguire l'override con un'implementazione appropriata. cancellationToken può facoltativamente essere rispettato. L'implementazione predefinita richiama la chiamata sincrona GetSchemaTable() e restituisce un'attività completata. L'implementazione predefinita restituirà un'attività annullata se viene passato un cancellationToken già annullato. Le eccezioni generate da GetSchemaTable() verranno passate mediante la proprietà Task Exception restituita.

(Ereditato da DbDataReader)
GetStream(Int32)

Ottiene un flusso per recuperare i dati dalla colonna specificata.

(Ereditato da DbDataReader)
GetString(Int32)

Ottiene il valore della colonna specificata sotto forma di classe String.

GetTextReader(Int32)

Ottiene un lettore di testo per recuperare i dati dalla colonna.

(Ereditato da DbDataReader)
GetTime(Int32)

Ottiene il valore della colonna specificata come oggetto TimeSpan.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
GetValue(Int32)

Ottiene il valore della colonna in corrispondenza dell'ordinale specificato nel formato nativo.

GetValues(Object[])

Popola una matrice di oggetti con i valori della colonna della riga corrente.

InitializeLifetimeService()
Obsoleti.

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.

(Ereditato da MarshalByRefObject)
IsDBNull(Int32)

Ottiene un valore che indica se la colonna contiene valori non esistenti o mancanti.

IsDBNullAsync(Int32)

Ottiene un valore in modo asincrono, che indica se la colonna contiene valori non esistenti o mancanti.

(Ereditato da DbDataReader)
IsDBNullAsync(Int32, CancellationToken)

Ottiene un valore in modo asincrono, che indica se la colonna contiene valori non esistenti o mancanti.

(Ereditato da DbDataReader)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.

(Ereditato da MarshalByRefObject)
NextResult()

Sposta la classe OdbcDataReader sul risultato successivo durante la lettura dei risultati delle istruzioni batch SQL.

NextResultAsync()

Sposta in modo asincrono il lettore al risultato successivo durante la lettura dei risultati di un batch di istruzioni.

(Ereditato da DbDataReader)
NextResultAsync(CancellationToken)

Sposta in modo asincrono il lettore al risultato successivo durante la lettura dei risultati di un batch di istruzioni.

(Ereditato da DbDataReader)
Read()

Sposta l'oggetto OdbcDataReader al record successivo.

ReadAsync()

Sposta in modo asincrono il lettore al record successivo in un set di risultati.

(Ereditato da DbDataReader)
ReadAsync(CancellationToken)

Sposta in modo asincrono il lettore al record successivo in un set di risultati.

(Ereditato da DbDataReader)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Implementazioni dell'interfaccia esplicita

IDataRecord.GetData(Int32)

Per una descrizione di questo membro, vedere GetData(Int32).

(Ereditato da DbDataReader)
IDisposable.Dispose()

Questa API supporta l'infrastruttura del prodotto e non è previsto che venga usata direttamente dal codice.

Rilascia tutte le risorse usate dall'istanza corrente della classe OdbcDataReader.

IEnumerable.GetEnumerator()

Questa API supporta l'infrastruttura del prodotto e non è previsto che venga usata direttamente dal codice.

Restituisce un enumeratore che consente di eseguire l'iterazione di una raccolta.

Metodi di estensione

CanGetColumnSchema(DbDataReader)

Ottiene un valore che indica se un oggetto DbDataReader può ottenere uno schema di colonna.

GetColumnSchema(DbDataReader)

Ottiene lo schema di colonne (raccolta DbColumn) per un oggetto DbDataReader.

Cast<TResult>(IEnumerable)

Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.

OfType<TResult>(IEnumerable)

Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.

AsParallel(IEnumerable)

Consente la parallelizzazione di una query.

AsQueryable(IEnumerable)

Converte un oggetto IEnumerable in un oggetto IQueryable.

Si applica a

Vedi anche