DbDataReader Classe

Definizione

Spazio dei nomi:

System.Data.Common

Assembly:

System.Data.Common.dll

Source:

DbDataReader.cs

Legge un flusso di righe forward-only da un'origine dati.

public ref class DbDataReader abstract : MarshalByRefObject, IAsyncDisposable, IDisposable, System::Collections::IEnumerable, System::Data::IDataReader

public abstract class DbDataReader : MarshalByRefObject, IAsyncDisposable, IDisposable, System.Collections.IEnumerable, System.Data.IDataReader

type DbDataReader = class
    inherit MarshalByRefObject
    interface IEnumerable
    interface IDataReader
    interface IDataRecord
    interface IDisposable
    interface IAsyncDisposable

Public MustInherit Class DbDataReader
Inherits MarshalByRefObject
Implements IAsyncDisposable, IDataReader, IDisposable, IEnumerable

Ereditarietà

Object

MarshalByRefObject

DbDataReader

Derivato

System.Data.DataTableReader

System.Data.EntityClient.EntityDataReader

System.Data.Odbc.OdbcDataReader

System.Data.OleDb.OleDbDataReader

System.Data.SqlClient.SqlDataReader

Implementazioni

IEnumerable IDisposable IDataReader IDataRecord IAsyncDisposable

Costruttori

DbDataReader()

Inizializza una nuova istanza della classe DbDataReader.

Proprietà

Depth	Ottiene un valore che indica il livello di annidamento della riga corrente.
FieldCount	Quando ne viene eseguito l'override in una classe derivata, ottiene il numero di colonne nella riga corrente.
HasRows	Quando ne viene eseguito l'override in una classe derivata, ottiene un valore che indica se questo DbDataReader contiene una o più righe.
IsClosed	Quando ne viene eseguito l'override in una classe derivata, ottiene un valore che indica se DbDataReader è chiuso.
Item[Int32]	Quando ne viene eseguito l'override in una classe derivata, ottiene il valore della colonna specificata come istanza di Object.
Item[String]	Quando ne viene eseguito l'override in una classe derivata, ottiene il valore della colonna specificata come istanza di Object.
RecordsAffected	Quando ne viene eseguito l'override in una classe derivata, ottiene il numero di righe modificate, inserite o eliminate dall'esecuzione dell'istruzione SQL.
VisibleFieldCount	Ottiene il numero di campi non nascosti in DbDataReader.

Metodi

Close()	Chiude l'oggetto DbDataReader.
CloseAsync()	Chiude in modo asincrono l'oggetto 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.
Dispose(Boolean)	Rilascia le risorse non gestite usate da DbDataReader e, facoltativamente, le risorse gestite.
DisposeAsync()	Rilascia in modo asincrono le risorse usate dall'istanza corrente della classe DbDataReader.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetBoolean(Int32)	Quando ne viene eseguito l'override in una classe derivata, ottiene il valore della colonna specificata come valore booleano.
GetByte(Int32)	Quando ne viene eseguito l'override in una classe derivata, ottiene il valore della colonna specificata come byte.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Quando ne viene eseguito l'override in una classe derivata, 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(Int32)	Quando ne viene eseguito l'override in una classe derivata, ottiene il valore della colonna specificata come carattere singolo.
GetChars(Int32, Int64, Char[], Int32, Int32)	Quando ne viene eseguito l'override in una classe derivata, 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.
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.
GetData(Int32)	Restituisce un lettore di dati annidati per la colonna richiesta.
GetDataTypeName(Int32)	Quando ne viene eseguito l'override in una classe derivata, ottiene il nome del tipo di dati della colonna specificata.
GetDateTime(Int32)	Quando ne viene eseguito l'override in una classe derivata, 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.
GetDecimal(Int32)	Quando ne viene eseguito l'override in una classe derivata, ottiene il valore della colonna specificata come Decimal.
GetDouble(Int32)	Quando ne viene eseguito l'override in una classe derivata, ottiene il valore della colonna specificata come numero a virgola mobile a precisione doppia.
GetEnumerator()	Quando ne viene eseguito l'override in una classe derivata, restituisce un enumeratore che è possibile usare per scorrere le righe nel lettore di dati.
GetFieldType(Int32)	Quando ne viene eseguito l'override in una classe derivata, ottiene il tipo di dati della colonna specificata.
GetFieldValue<T>(Int32)	Ottiene il valore della colonna specificata come tipo richiesto.
GetFieldValueAsync<T>(Int32)	Ottiene in modo asincrono il valore della colonna specificata come tipo richiesto.
GetFieldValueAsync<T>(Int32, CancellationToken)	Ottiene in modo asincrono il valore della colonna specificata come tipo richiesto.
GetFloat(Int32)	Quando ne viene eseguito l'override in una classe derivata, ottiene il valore della colonna specificata come numero a virgola mobile a precisione singola.
GetGuid(Int32)	Quando ne viene eseguito l'override in una classe derivata, ottiene il valore della colonna specificata come identificatore univoco globale (GUID).
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetInt16(Int32)	Quando ne viene eseguito l'override in una classe derivata, ottiene il valore della colonna specificata come intero con segno a 16 bit.
GetInt32(Int32)	Quando ne viene eseguito l'override in una classe derivata, ottiene il valore della colonna specificata come intero con segno a 32 bit.
GetInt64(Int32)	Quando ne viene eseguito l'override in una classe derivata, ottiene il valore della colonna specificata come intero 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)	Quando ne viene eseguito l'override in una classe derivata, ottiene il nome della colonna, quando viene specificato l'ordinale di colonna in base zero.
GetOrdinal(String)	Quando ne viene eseguito l'override in una classe derivata, ottiene l'ordinale di colonna, quando viene specificato il nome della colonna.
GetProviderSpecificFieldType(Int32)	Restituisce il tipo specifico del provider per la colonna indicata.
GetProviderSpecificValue(Int32)	Ottiene il valore della colonna specificata come istanza di un tipo specifico del provider.
GetProviderSpecificValues(Object[])	Ottiene tutte le colonne attributo specifiche del provider nella raccolta per la riga corrente.
GetSchemaTable()	Restituisce un oggetto DataTable che descrive i metadati della colonna di DbDataReader. Restituisce null se il comando eseguito non ha restituito alcun set di risultati o dopo NextResult() restituisce false.
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.
GetStream(Int32)	Ottiene un flusso per recuperare i dati dalla colonna specificata.
GetString(Int32)	Quando ne viene eseguito l'override in una classe derivata, ottiene il valore della colonna specificata come istanza di String.
GetTextReader(Int32)	Ottiene un lettore di testo per recuperare i dati dalla colonna.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
GetValue(Int32)	Quando ne viene eseguito l'override in una classe derivata, ottiene il valore della colonna specificata come istanza di Object.
GetValues(Object[])	Quando ne viene eseguito l'override in un classe derivata, 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)	Quando ne viene eseguito l'override in una classe derivata, ottiene un valore che indica se la colonna contiene valori mancanti o inesistenti.
IsDBNullAsync(Int32)	Ottiene un valore in modo asincrono, che indica se la colonna contiene valori non esistenti o mancanti.
IsDBNullAsync(Int32, CancellationToken)	Ottiene un valore in modo asincrono, che indica se la colonna contiene valori non esistenti o mancanti.
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()	Quando ne viene eseguito l'override in una classe derivata, sposta il lettore al risultato successivo durante la lettura dei risultati di un batch di istruzioni.
NextResultAsync()	Sposta in modo asincrono il lettore al risultato successivo durante la lettura dei risultati di un batch di istruzioni.
NextResultAsync(CancellationToken)	Sposta in modo asincrono il lettore al risultato successivo durante la lettura dei risultati di un batch di istruzioni.
Read()	Quando ne viene eseguito l'override in una classe derivata, fa avanzare il lettore al record successivo in un set di risultati.
ReadAsync()	Sposta in modo asincrono il lettore al record successivo in un set di risultati.
ReadAsync(CancellationToken)	Sposta in modo asincrono il lettore al record successivo in un set di risultati.
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).

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.
GetBoolean(DbDataReader, String)	Ottiene il valore della colonna specificata come valore Boolean.
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 carattere singolo.
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 annidati 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 sotto forma di classe 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 con 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 sotto forma di 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 integer con segno a 64 bit.
GetProviderSpecificFieldType(DbDataReader, String)	Restituisce il tipo specifico del provider per la colonna indicata.
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 i 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 non esistenti o mancanti.
IsDBNullAsync(DbDataReader, String, CancellationToken)	Ottiene un valore in modo asincrono, che indica se la colonna contiene valori non esistenti o mancanti.
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.
ConfigureAwait(IAsyncDisposable, Boolean)	Consente di configurare la modalità di esecuzione delle espressioni await per le attività restituite da un elemento disposable asincrono.

Vedi anche

• Oggetti DbProviderFactory (ADO.NET)
• Panoramica di ADO.NET