DataTableReader Classe

Definizione

Spazio dei nomi:

System.Data

Assembly:

System.Data.Common.dll

Origine:

DataTableReader.cs

Il DataTableReader ottiene 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

Il DataTableReader funziona in modo analogo a qualsiasi altro lettore di dati, ad esempio il SqlDataReader, ad eccezione del fatto che l'DataTableReader fornisce l'iterazione delle righe in un DataTable. In altre parole, fornisce l'iterazione delle righe in una cache. I dati memorizzati nella cache possono essere modificati mentre il DataTableReader è attivo e il lettore mantiene automaticamente la posizione.

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

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

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

Costruttori

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

Proprietà

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

Metodi

Close()	Chiude il DataTableReadercorrente.
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)
GetBoolean(Int32)	Ottiene il valore della colonna specificata come 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 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)	Restituisce il valore della colonna specificata come matrice di caratteri.
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 lettore di dati annidato 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 con un'implementazione specifica del provider. (Ereditato da DbDataReader)
GetDecimal(Int32)	Ottiene il valore della colonna specificata come Decimal.
GetDouble(Int32)	Ottiene il valore della colonna come numero a virgola mobile a precisione doppia.
GetEnumerator()	Restituisce un enumeratore che può essere utilizzato per scorrere la raccolta di elementi.
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)	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 a 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 valore della colonna specificata come String.
GetOrdinal(String)	Ottiene l'ordinale di colonna, in base al nome della colonna.
GetProviderSpecificFieldType(Int32)	Ottiene il tipo della colonna specificata nel formato specifico del provider.
GetProviderSpecificValue(Int32)	Ottiene il valore della colonna specificata in formato specifico del provider.
GetProviderSpecificValues(Object[])	Riempie la matrice fornita con informazioni sul tipo specifiche del provider per tutte le colonne del DataTableReader.
GetSchemaTable()	Restituisce un DataTable che descrive i metadati della colonna del DataTableReader.
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)
GetType()	Ottiene il 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 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)	Ottiene in modo asincrono un valore che indica se la colonna contiene valori inesistenti o mancanti. (Ereditato da DbDataReader)
IsDBNullAsync(Int32, CancellationToken)	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 DataTableReader al set di risultati successivo, se presente.
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 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 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.