DataTableReader Classe

Definizione

Spazio dei nomi:

System.Data

Assembly:

System.Data.Common.dll

Assembly:

System.Data.dll

Assembly:

netstandard.dll

Il tipo DataTableReader presenta il contenuto di uno o più oggetti DataTable sotto forma di uno o più set di risultati forward-only di sola lettura.

public ref class DataTableReader sealed : System::Data::Common::DbDataReader

public sealed class DataTableReader : System.Data.Common.DbDataReader

type DataTableReader = class
    inherit DbDataReader

Public NotInheritable Class DataTableReader
Inherits DbDataReader

Ereditarietà

Object

MarshalByRefObject

DbDataReader

DataTableReader

Commenti

L'oggetto DataTableReader funziona molto come qualsiasi altro lettore di dati, ad esempio , ad eccezione del fatto che l'iterazione SqlDataReaderDataTableReader delle righe in un DataTableoggetto . In altre parole, fornisce l'iterazione delle righe in una cache. I dati memorizzati nella cache possono essere modificati mentre l'oggetto DataTableReader è attivo e il lettore mantiene automaticamente la sua posizione.

Quando si crea un DataTableReader DataTableoggetto da , l'oggetto risultante DataTableReader contiene un set di risultati con gli stessi dati DataTable da cui è stato creato, ad eccezione di eventuali righe contrassegnate come eliminate. Le colonne vengono visualizzate nello stesso ordine dell'oggetto originale DataTable. La struttura del risultato restituito è identica nello schema e nei dati dell'originale DataTable. Oggetto DataTableReader creato chiamando il CreateDataReader metodo di un DataSet oggetto contiene più set di risultati se contiene DataSet più tabelle. I risultati si trovano nella stessa sequenza DataTable degli oggetti nell'oggetto DataTableCollection DataSet .

Il set di risultati restituito contiene solo la versione corrente di ogni DataRow. Le righe contrassegnate per l'eliminazione vengono ignorate.

Fornisce DataTableReader un iteratore stabile, ovvero il contenuto dell'oggetto DataTableReader non è invalidato se le dimensioni della raccolta sottostante vengono modificate durante l'iterazione. Ad esempio, se una o più righe nella Rows raccolta vengono eliminate o rimosse durante l'iterazione, la posizione corrente all'interno DataTableReader dell'oggetto viene mantenuta in modo appropriato e non invalida l'iteratore.

Costruttori

DataTableReader(DataTable)	Inizializza una nuova istanza della classe DataTableReader utilizzando i dati dalla classe DataTable fornita.
DataTableReader(DataTable[])	Inizializza una nuova istanza della classe DataTableReader con la matrice di oggetti DataTable fornita.

Proprietà

Depth	Livello di annidamento della riga corrente della classe DataTableReader.
FieldCount	Restituisce il numero di colonne nella riga corrente.
HasRows	Ottiene un valore che indica se la classe DataTableReader contiene una o più righe.
IsClosed	Ottiene un valore che indica se la classe DataTableReader è 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 inserite, modificate o eliminate dall'esecuzione dell'istruzione SQL.
VisibleFieldCount	Ottiene il numero di campi non nascosti in DbDataReader. (Ereditato da DbDataReader)

Metodi

Close()	Chiude la classe DataTableReader corrente.
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)
GetBoolean(Int32)	Ottiene il valore della colonna specificata sotto forma di classe Boolean.
GetByte(Int32)	Ottiene il valore della colonna specificata come byte.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Legge un flusso di byte a partire dall'offset specificato della colonna e lo copia come matrice nel buffer, a partire dall'offset specificato del buffer.
GetChar(Int32)	Ottiene il valore della colonna specificata sotto forma di carattere.
GetChars(Int32, Int64, Char[], Int32, Int32)	Restituisce il valore della colonna specificata come stringa di caratteri.
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 un lettore di dati annidati per la colonna richiesta. (Ereditato da DbDataReader)
GetDataTypeName(Int32)	Ottiene una stringa che rappresenta il tipo di dati della colonna specificata.
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 sotto forma di classe Decimal.
GetDouble(Int32)	Ottiene il valore della colonna sotto forma di numero a virgola mobile e precisione doppia.
GetEnumerator()	Restituisce un enumeratore che può essere utilizzato per scorrere l'insieme di elementi.
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 come numero a virgola mobile con 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()	Obsoleta. 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 valore della colonna specificata sotto forma di classe String.
GetOrdinal(String)	Ottiene la posizione ordinale della colonna, dato il nome della colonna.
GetProviderSpecificFieldType(Int32)	Ottiene il tipo della colonna specificata nel formato specifico del provider.
GetProviderSpecificValue(Int32)	Ottiene il valore della colonna specificata nel formato specifico del provider.
GetProviderSpecificValues(Object[])	Riempie la matrice fornita con le informazioni sul tipo specifico del provider per tutte le colonne nella classe DataTableReader.
GetSchemaTable()	Restituisce un oggetto DataTable che descrive i metadati della colonna di DataTableReader.
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 stringa.
GetTextReader(Int32)	Ottiene un lettore di testo per recuperare i dati dalla colonna. (Ereditato da DbDataReader)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
GetValue(Int32)	Ottiene il valore della colonna specificata nel formato nativo.
GetValues(Object[])	Popola una matrice di oggetti con i valori della colonna della riga corrente.
InitializeLifetimeService()	Obsoleta. 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 DataTableReader al gruppo di risultati successivo, se esistente.
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 DataTableReader 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)

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.