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.
DataTableReader Ottiene il contenuto di uno o più oggetti sotto forma di uno o più DataTable set di risultati forward-only di sola lettura.
public ref class DataTableReader sealed : System::Data::Common::DbDataReaderpublic sealed class DataTableReader : System.Data.Common.DbDataReadertype DataTableReader = class
inherit DbDataReaderPublic NotInheritable Class DataTableReader
Inherits DbDataReader- Ereditarietà
Commenti
Funziona DataTableReader in modo analogo a qualsiasi altro lettore di dati, ad esempio , ad eccezione del fatto che fornisce l'iterazione SqlDataReaderDataTableReader sulle righe in un oggetto DataTable. In altre parole, fornisce l'iterazione delle righe in una cache. I dati memorizzati nella cache possono essere modificati mentre DataTableReader è attivo e il lettore mantiene automaticamente la posizione.
Quando si crea un oggetto DataTableReader da un DataTableoggetto , l'oggetto risultante DataTableReader contiene un set di risultati con gli stessi dati dell'oggetto DataTable da cui è stato creato, ad eccezione di tutte le 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'oggetto originale DataTable. Oggetto DataTableReader creato chiamando il CreateDataReader metodo di un DataSet oggetto contiene più set di risultati se DataSet contiene più tabelle. I risultati si trovano nella stessa sequenza degli DataTable 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 di DataTableReader non viene 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 di viene mantenuta in modo appropriato e non invalida l'iteratore.
Costruttori
| Nome | Descrizione |
|---|---|
| DataTableReader(DataTable) |
Inizializza una nuova istanza della DataTableReader classe utilizzando i dati dell'oggetto fornito DataTable. |
| DataTableReader(DataTable[]) |
Inizializza una nuova istanza della DataTableReader classe utilizzando la matrice di DataTable oggetti fornita. |
Proprietà
| Nome | Descrizione |
|---|---|
| Depth |
Profondità dell'annidamento per la riga corrente di DataTableReader. |
| FieldCount |
Restituisce il numero di colonne nella riga corrente. |
| HasRows |
Ottiene un valore che indica se contiene DataTableReader una o più righe. |
| IsClosed |
Ottiene un valore che indica se l'oggetto DataTableReader è 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 inserite, modificate o eliminate dall'esecuzione dell'istruzione SQL. |
| VisibleFieldCount |
Ottiene il numero di campi nell'oggetto DbDataReader che non sono nascosti. (Ereditato da DbDataReader) |
Metodi
| Nome | Descrizione |
|---|---|
| Close() |
Chiude l'oggetto corrente DataTableReader. |
| 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 DbDataReader classe . (Ereditato da DbDataReader) |
| Dispose(Boolean) |
Rilascia le risorse non gestite usate da DbDataReader e, facoltativamente, rilascia le risorse gestite. (Ereditato da DbDataReader) |
| DisposeAsync() |
Rilascia in modo asincrono tutte le risorse usate dall'istanza corrente della DbDataReader classe . (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 oggetto 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. |
| 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 DateTime oggetto . |
| GetDbDataReader(Int32) |
Restituisce un DbDataReader oggetto per l'ordinale di colonna richiesta 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 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 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, 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 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() |
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 oggetto 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 nell'oggetto DataTableReader. |
| GetSchemaTable() |
Restituisce un oggetto DataTable che descrive i metadati della colonna dell'oggetto DataTableReader. |
| 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() |
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 corrente MarshalByRefObject . (Ereditato da MarshalByRefObject) |
| NextResult() |
Sposta l'oggetto 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 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
| Nome | Descrizione |
|---|---|
| IDataRecord.GetData(Int32) |
Per una descrizione di questo membro, vedere GetData(Int32). (Ereditato da DbDataReader) |
Metodi di estensione
| Nome | Descrizione |
|---|---|
| AsParallel(IEnumerable) |
Abilita la parallelizzazione di una query. |
| AsQueryable(IEnumerable) |
Converte un IEnumerable in un IQueryable. |
| CanGetColumnSchema(DbDataReader) |
Ottiene un valore che indica se un DbDataReader oggetto può ottenere uno schema di colonna. |
| Cast<TResult>(IEnumerable) |
Esegue il cast degli elementi di un IEnumerable al tipo specificato. |
| ConfigureAwait(IAsyncDisposable, Boolean) |
Configura il modo in cui verranno eseguite le attese nelle attività restituite da un oggetto eliminabile asincrono. |
| 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. |
| GetColumnSchema(DbDataReader) |
Ottiene lo schema della colonna (DbColumn raccolta) per un oggetto DbDataReader. |
| 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 DateTime oggetto . |
| GetDecimal(DbDataReader, String) |
Ottiene il valore della colonna specificata come oggetto 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. |
| OfType<TResult>(IEnumerable) |
Filtra gli elementi di un IEnumerable in base a un tipo specificato. |