OleDbDataReader Classe

  • Riferimento

Definizione

Spazio dei nomi:
System.Data.OleDb
Assembly:
System.Data.OleDb.dll
Assembly:
System.Data.dll
Pacchetto:
System.Data.OleDb v8.0.1
Pacchetto:
System.Data.OleDb v9.0.0-rc.2.24473.5
Origine:
OleDbDataReader.cs
Origine:
OleDbDataReader.cs
Origine:
OleDbDataReader.cs
Origine:
OleDbDataReader.cs
Origine:
OleDbDataReader.cs

Consente di leggere un flusso forward-only di righe di dati da un'origine dati. Questa classe non può essere ereditata.

public ref class OleDbDataReader sealed : System::Data::Common::DbDataReader
public ref class OleDbDataReader sealed : MarshalByRefObject, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader
public sealed class OleDbDataReader : System.Data.Common.DbDataReader
public sealed class OleDbDataReader : MarshalByRefObject, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader
type OleDbDataReader = class
    inherit DbDataReader
type OleDbDataReader = class
    inherit MarshalByRefObject
    interface IDataReader
    interface IDisposable
    interface IDataRecord
    interface IEnumerable
Public NotInheritable Class OleDbDataReader
Inherits DbDataReader
Public NotInheritable Class OleDbDataReader
Inherits MarshalByRefObject
Implements IDataReader, IDisposable, IEnumerable
Ereditarietà
Object
MarshalByRefObject
DbDataReader
OleDbDataReader
Ereditarietà
Object
MarshalByRefObject
OleDbDataReader
Implementazioni
IEnumerable IDataReader IDataRecord IDisposable

Esempio

Nell'esempio seguente viene creato un OleDbConnection, un OleDbCommande un OleDbDataReader. L'esempio legge i dati, scrivendoli nella console. Infine, l'esempio chiude il OleDbDataReader e quindi il 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

Commenti

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

Prima di chiudere il OleDbConnection, chiudere prima l'oggetto OleDbDataReader. È inoltre necessario chiudere l'oggetto OleDbDataReader se si prevede di ripristinare un oggetto OleDbCommand. 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 mentre i dati vengono letti possono essere visibili all'utente del OleDbDataReader. Tuttavia, il comportamento preciso dipende dalla tempistica.

IsClosed e RecordsAffected sono le uniche proprietà che è possibile chiamare dopo la chiusura del OleDbDataReader. Anche se è possibile accedere alla proprietà RecordsAffected mentre il OleDbDataReader esiste, chiamare sempre Close prima di restituire il valore di RecordsAffected per garantire un valore restituito accurato.

Proprietà

Depth

Ottiene un valore che indica la profondità di annidamento per la riga corrente.
FieldCount

Ottiene il numero di colonne nella riga corrente.
HasRows

Ottiene un valore che indica se la OleDbDataReader contiene una o più righe.
IsClosed

Indica se il lettore dati è chiuso.
Item[Int32]

Ottiene il valore della colonna specificata nel formato nativo in base all'ordinale di colonna.
Item[String]

Ottiene il valore della colonna specificata nel formato nativo in base al nome della colonna.
RecordsAffected

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

Ottiene il numero di campi nella OleDbDataReader che non sono nascosti.

Metodi

Close()

Chiude l'oggetto OleDbDataReader.
CloseAsync()

Chiude in modo asincrono l'oggetto DbDataReader.

(Ereditato da DbDataReader)
CreateObjRef(Type)

Crea un oggetto che contiene tutte le informazioni pertinenti necessarie per generare un proxy utilizzato per comunicare 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 dal DbDataReader e, facoltativamente, rilascia le risorse gestite.

(Ereditato da DbDataReader)
DisposeAsync()

Rilascia in modo asincrono tutte 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 venga recuperata da Garbage Collection.
GetBoolean(Int32)

Ottiene il valore della colonna specificata come valore booleano.
GetByte(Int32)

Ottiene il valore della colonna specificata come byte.
GetBytes(Int32, Int64, Byte[], Int32, Int32)

Legge un flusso di byte dall'offset di colonna specificato nel buffer come matrice a partire dall'offset del buffer specificato.
GetChar(Int32)

Ottiene il valore della colonna specificata come carattere.
GetChars(Int32, Int64, Char[], Int32, Int32)

Legge un flusso di caratteri dall'offset di colonna specificato nel buffer come 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. Il cancellationToken può essere rispettato facoltativamente. L'implementazione predefinita richiama la GetColumnSchema(DbDataReader) sincrona e restituisce un'attività completata. L'implementazione predefinita restituirà un'attività annullata se è stata passata una cancellationTokengià annullata. Le eccezioni generate da GetColumnSchema(DbDataReader) verranno comunicate tramite la proprietà Task Exception restituita.

(Ereditato da DbDataReader)
GetData(Int32)

Restituisce un oggetto OleDbDataReader per l'ordinale di colonna richiesto.
GetDataTypeName(Int32)

Ottiene il nome del tipo di dati di origine.
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 con 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 come numero a virgola mobile e precisione doppia.
GetEnumerator()

Restituisce un IEnumerator che può essere utilizzato per scorrere le righe nel lettore dati.
GetFieldType(Int32)

Ottiene il 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, CancellationToken)

Ottiene in modo asincrono 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)
GetFloat(Int32)

Ottiene il valore della colonna specificata come numero a 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 come 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 intero con segno a 64 bit.
GetLifetimeService()
Obsoleti.

Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza.

(Ereditato da MarshalByRefObject)
GetName(Int32)

Ottiene il nome della colonna specificata.
GetOrdinal(String)

Ottiene l'ordinale di colonna, in base al nome della colonna.
GetProviderSpecificFieldType(Int32)

Ottiene il tipo specifico del provider della colonna specificata.

(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 di attributi specifiche del provider nella raccolta per la riga corrente.

(Ereditato da DbDataReader)
GetSchemaTable()

Restituisce un DataTable che descrive i metadati della colonna del OleDbDataReader.
GetSchemaTableAsync(CancellationToken)

Si tratta della versione asincrona di GetSchemaTable(). I provider devono eseguire l'override con un'implementazione appropriata. Il cancellationToken può essere rispettato facoltativamente. L'implementazione predefinita richiama la GetSchemaTable() sincrona e restituisce un'attività completata. L'implementazione predefinita restituirà un'attività annullata se è stata passata una cancellationTokengià annullata. Le eccezioni generate da GetSchemaTable() verranno comunicate tramite la proprietà Task Exception restituita.

(Ereditato da DbDataReader)
GetStream(Int32)

Ottiene un flusso per recuperare dati dalla colonna specificata.

(Ereditato da DbDataReader)
GetString(Int32)

Ottiene il valore della colonna specificata come stringa.
GetTextReader(Int32)

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

(Ereditato da DbDataReader)
GetTimeSpan(Int32)

Ottiene il valore della colonna specificata come oggetto TimeSpan.
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
GetValue(Int32)

Ottiene il valore della colonna in corrispondenza del numero ordinale specificato nel formato nativo.
GetValues(Object[])

Popola una matrice di oggetti con i valori di 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 inesistenti o mancanti.
IsDBNullAsync(Int32, CancellationToken)

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

(Ereditato da DbDataReader)
IsDBNullAsync(Int32)

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

(Ereditato da DbDataReader)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
MemberwiseClone(Boolean)

Crea una copia superficiale dell'oggetto MarshalByRefObject corrente.

(Ereditato da MarshalByRefObject)
NextResult()

Sposta il lettore dati al risultato successivo, durante la lettura dei risultati delle istruzioni SQL batch.
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 il OleDbDataReader 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)

Restituisce un IDataReader per l'ordinale di colonna specificato.
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 le risorse usate dall'istanza corrente della classe OleDbDataReader.
IEnumerable.GetEnumerator()

Restituisce un enumeratore che scorre un insieme.

Metodi di estensione

CanGetColumnSchema(DbDataReader)

Ottiene un valore che indica se un DbDataReader può ottenere uno schema di colonna.
GetColumnSchema(DbDataReader)

Ottiene lo schema della colonna (DbColumn raccolta) per un DbDataReader.
GetBoolean(DbDataReader, String)

Ottiene il valore della colonna specificata come valore booleano.
GetByte(DbDataReader, String)

Ottiene il valore della colonna specificata come byte.
GetBytes(DbDataReader, String, Int64, Byte[], Int32, Int32)

Legge un numero specificato di byte dalla colonna specificata a partire da un indice specificato e li scrive in un buffer a partire da una posizione specificata nel buffer.
GetChar(DbDataReader, String)

Ottiene il valore della colonna specificata come singolo carattere.
GetChars(DbDataReader, String, Int64, Char[], Int32, Int32)

Legge un numero specificato di caratteri da una colonna specificata a partire da un indice specificato e li scrive in un buffer a partire da una posizione specificata.
GetData(DbDataReader, String)

Restituisce un lettore di dati annidato per la colonna richiesta.
GetDataTypeName(DbDataReader, String)

Ottiene il nome del tipo di dati della colonna specificata.
GetDateTime(DbDataReader, String)

Ottiene il valore della colonna specificata come oggetto DateTime.
GetDecimal(DbDataReader, String)

Ottiene il valore della colonna specificata come Decimal.
GetDouble(DbDataReader, String)

Ottiene il valore della colonna specificata come numero a virgola mobile a precisione doppia.
GetFieldType(DbDataReader, String)

Ottiene il tipo di dati della colonna specificata.
GetFieldValue<T>(DbDataReader, String)

Ottiene il valore della colonna specificata come tipo richiesto.
GetFieldValueAsync<T>(DbDataReader, String, CancellationToken)

Ottiene in modo asincrono il valore della colonna specificata come tipo richiesto.
GetFloat(DbDataReader, String)

Ottiene il valore della colonna specificata come numero a virgola mobile a precisione singola.
GetGuid(DbDataReader, String)

Ottiene il valore della colonna specificata come identificatore univoco globale (GUID).
GetInt16(DbDataReader, String)

Ottiene il valore della colonna specificata come intero con segno a 16 bit.
GetInt32(DbDataReader, String)

Ottiene il valore della colonna specificata come intero con segno a 32 bit.
GetInt64(DbDataReader, String)

Ottiene il valore della colonna specificata come intero con segno a 64 bit.
GetProviderSpecificFieldType(DbDataReader, String)

Ottiene il tipo specifico del provider della colonna specificata.
GetProviderSpecificValue(DbDataReader, String)

Ottiene il valore della colonna specificata come istanza di un tipo specifico del provider.
GetStream(DbDataReader, String)

Ottiene un flusso per recuperare dati dalla colonna specificata.
GetString(DbDataReader, String)

Ottiene il valore della colonna specificata come istanza di String.
GetTextReader(DbDataReader, String)

Ottiene un lettore di testo per recuperare i dati dalla colonna.
GetValue(DbDataReader, String)

Ottiene il valore della colonna specificata come istanza di Object.
IsDBNull(DbDataReader, String)

Ottiene un valore che indica se la colonna contiene valori inesistenti o mancanti.
IsDBNullAsync(DbDataReader, String, CancellationToken)

Ottiene in modo asincrono un valore che indica se la colonna contiene valori inesistenti o mancanti.
Cast<TResult>(IEnumerable)

Esegue il cast degli elementi di un IEnumerable al tipo specificato.
OfType<TResult>(IEnumerable)

Filtra gli elementi di un IEnumerable in base a un tipo specificato.
AsParallel(IEnumerable)

Abilita la parallelizzazione di una query.
AsQueryable(IEnumerable)

Converte un IEnumerable in un IQueryable.
ConfigureAwait(IAsyncDisposable, Boolean)

Configura il modo in cui verranno eseguite le attese nelle attività restituite da un oggetto eliminabile asincrono.

Si applica a

Vedi anche