DataTableReader Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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à
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.
|
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.
|
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. |