DataTableReader DataTableReader DataTableReader DataTableReader Class

Definizione

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.The DataTableReader obtains the contents of one or more DataTable objects in the form of one or more read-only, forward-only result sets.

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

Il DataTableReader funziona in modo analogo a qualsiasi altro lettore di dati, ad esempio il SqlDataReader, ad eccezione del fatto che le DataTableReader consente di scorrere le righe in un DataTable.The DataTableReader works much like any other data reader, such as the SqlDataReader, except that the DataTableReader provides for iterating over rows in a DataTable. In altre parole, consente di scorrere le righe in una cache.In other words, it provides for iterating over rows in a cache. I dati memorizzati nella cache possono essere modificati mentre il DataTableReader è attivo, e il lettore mantiene automaticamente la posizione.The cached data can be modified while the DataTableReader is active, and the reader automatically maintains its position.

Quando si crea una DataTableReader da un DataTable, risultante DataTableReader oggetto contiene un set di risultati con gli stessi dati il DataTable da cui è stata creata, ad eccezione delle righe che sono state contrassegnate come eliminati.When you create a DataTableReader from a DataTable, the resulting DataTableReader object contains one result set with the same data as the DataTable from which it was created, except for any rows that have been marked as deleted. Le colonne sono visualizzate nello stesso ordine come originale DataTable.The columns appear in the same order as in the original DataTable. La struttura del risultato restituito è identica nello schema e dati con la versione originale DataTable.The structure of the returned result is identical in schema and data to the original DataTable. Oggetto DataTableReader che è stato creato chiamando il CreateDataReader metodo di un DataSet oggetto contiene più set di risultati se la DataSet contiene più di una tabella.A DataTableReader that was created by calling the CreateDataReader method of a DataSet object contains multiple result sets if the DataSet contains more than one table. I risultati sono nella stessa sequenza in cui il DataTable oggetti nel DataTableCollection del DataSet oggetto.The results are in the same sequence as the DataTable objects in the DataTableCollection of the DataSet object.

Set di risultati restituito contiene solo la versione corrente di ogni DataRow; vengono ignorate le righe contrassegnate per l'eliminazione.The returned result set contains only the current version of each DataRow; rows that are marked for deletion are skipped.

Il DataTableReader fornisce un gruppo stabile iteratore, vale a dire il contenuto del DataTableReader non vengono invalidati se le dimensioni della raccolta sottostante vengano modificata durante l'iterazione.The DataTableReader provides a stable iterator; that is, the contents of the DataTableReader are not invalidated if the size of the underlying collection is modified during iteration. Ad esempio, se uno o più righe nel Rows raccolta vengono eliminati o rimossi durante l'iterazione, la posizione corrente all'interno del DataTableReader viene mantenuto in modo appropriato e non invalida l'iteratore.For example, if one or more rows in the Rows collection are deleted or removed during iteration, the current position within the DataTableReader is maintained appropriately and it does not invalidate the iterator.

Costruttori

DataTableReader(DataTable) DataTableReader(DataTable) DataTableReader(DataTable) DataTableReader(DataTable)

Inizializza una nuova istanza della classe DataTableReader utilizzando i dati dalla classe DataTable fornita.Initializes a new instance of the DataTableReader class by using data from the supplied DataTable.

DataTableReader(DataTable[]) DataTableReader(DataTable[]) DataTableReader(DataTable[]) DataTableReader(DataTable[])

Inizializza una nuova istanza della classe DataTableReader con la matrice di oggetti DataTable fornita.Initializes a new instance of the DataTableReader class using the supplied array of DataTable objects.

Proprietà

Depth Depth Depth Depth

Livello di annidamento della riga corrente della classe DataTableReader.The depth of nesting for the current row of the DataTableReader.

FieldCount FieldCount FieldCount FieldCount

Restituisce il numero di colonne nella riga corrente.Returns the number of columns in the current row.

HasRows HasRows HasRows HasRows

Ottiene un valore che indica se la classe DataTableReader contiene una o più righe.Gets a value that indicates whether the DataTableReader contains one or more rows.

IsClosed IsClosed IsClosed IsClosed

Ottiene un valore che indica se la classe DataTableReader è chiusa.Gets a value that indicates whether the DataTableReader is closed.

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Ottiene il valore della colonna specificata nel formato nativo, data la posizione ordinale della colonna.Gets the value of the specified column in its native format given the column ordinal.

Item[String] Item[String] Item[String] Item[String]

Ottiene il valore della colonna specificata nel formato nativo, dato il nome della colonna.Gets the value of the specified column in its native format given the column name.

RecordsAffected RecordsAffected RecordsAffected RecordsAffected

Ottiene il numero di righe inserite, modificate o eliminate dall'esecuzione dell'istruzione SQL.Gets the number of rows inserted, changed, or deleted by execution of the SQL statement.

VisibleFieldCount VisibleFieldCount VisibleFieldCount VisibleFieldCount

Ottiene il numero di campi non nascosti in DbDataReader.Gets the number of fields in the DbDataReader that are not hidden.

(Inherited from DbDataReader)

Metodi

Close() Close() Close() Close()

Chiude la classe DataTableReader corrente.Closes the current DataTableReader.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) 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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Rilascia tutte le risorse usate dall'istanza corrente della classe DbDataReader.Releases all resources used by the current instance of the DbDataReader class.

(Inherited from DbDataReader)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Libera le risorse gestite utilizzate dalla classe DbDataReader ed eventualmente libera le risorse non gestite.Releases the managed resources used by the DbDataReader and optionally releases the unmanaged resources.

(Inherited from DbDataReader)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetBoolean(Int32) GetBoolean(Int32) GetBoolean(Int32) GetBoolean(Int32)

Ottiene il valore della colonna specificata sotto forma di classe Boolean.Gets the value of the specified column as a Boolean.

GetByte(Int32) GetByte(Int32) GetByte(Int32) GetByte(Int32)

Ottiene il valore della colonna specificata come byte.Gets the value of the specified column as a byte.

GetBytes(Int32, Int64, Byte[], Int32, Int32) GetBytes(Int32, Int64, Byte[], Int32, Int32) GetBytes(Int32, Int64, Byte[], Int32, Int32) 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.Reads a stream of bytes starting at the specified column offset into the buffer as an array starting at the specified buffer offset.

GetChar(Int32) GetChar(Int32) GetChar(Int32) GetChar(Int32)

Ottiene il valore della colonna specificata sotto forma di carattere.Gets the value of the specified column as a character.

GetChars(Int32, Int64, Char[], Int32, Int32) GetChars(Int32, Int64, Char[], Int32, Int32) GetChars(Int32, Int64, Char[], Int32, Int32) GetChars(Int32, Int64, Char[], Int32, Int32)

Restituisce il valore della colonna specificata come stringa di caratteri.Returns the value of the specified column as a character array.

GetData(Int32) GetData(Int32) GetData(Int32) GetData(Int32)

Restituisce un oggetto DbDataReader per l'ordinale della colonna richiesta.Returns a DbDataReader object for the requested column ordinal.

(Inherited from DbDataReader)
GetDataTypeName(Int32) GetDataTypeName(Int32) GetDataTypeName(Int32) GetDataTypeName(Int32)

Ottiene una stringa che rappresenta il tipo di dati della colonna specificata.Gets a string representing the data type of the specified column.

GetDateTime(Int32) GetDateTime(Int32) GetDateTime(Int32) GetDateTime(Int32)

Ottiene il valore della colonna specificata come oggetto DateTime.Gets the value of the specified column as a DateTime object.

GetDbDataReader(Int32) GetDbDataReader(Int32) GetDbDataReader(Int32) GetDbDataReader(Int32)

Restituisce un oggetto DbDataReader per l'ordinale di colonna richiesto, di cui è possibile eseguire l'override tramite un'implementazione specifica del provider.Returns a DbDataReader object for the requested column ordinal that can be overridden with a provider-specific implementation.

(Inherited from DbDataReader)
GetDecimal(Int32) GetDecimal(Int32) GetDecimal(Int32) GetDecimal(Int32)

Ottiene il valore della colonna specificata sotto forma di classe Decimal.Gets the value of the specified column as a Decimal.

GetDouble(Int32) GetDouble(Int32) GetDouble(Int32) GetDouble(Int32)

Ottiene il valore della colonna sotto forma di numero a virgola mobile e precisione doppia.Gets the value of the column as a double-precision floating point number.

GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Restituisce un enumeratore che può essere utilizzato per scorrere l'insieme di elementi.Returns an enumerator that can be used to iterate through the item collection.

GetFieldType(Int32) GetFieldType(Int32) GetFieldType(Int32) GetFieldType(Int32)

Ottiene l'oggetto Type che rappresenta il tipo di dati dell'oggetto.Gets the Type that is the data type of the object.

GetFieldValue<T>(Int32) GetFieldValue<T>(Int32) GetFieldValue<T>(Int32) GetFieldValue<T>(Int32)

Ottiene in modo sincrono il valore della colonna specificata sotto forma di tipo.Synchronously gets the value of the specified column as a type.

(Inherited from DbDataReader)
GetFieldValueAsync<T>(Int32) GetFieldValueAsync<T>(Int32) GetFieldValueAsync<T>(Int32) GetFieldValueAsync<T>(Int32)

Ottiene in modo sincrono il valore della colonna specificata come tipo.Asynchronously gets the value of the specified column as a type.

(Inherited from DbDataReader)
GetFieldValueAsync<T>(Int32, CancellationToken) GetFieldValueAsync<T>(Int32, CancellationToken) GetFieldValueAsync<T>(Int32, CancellationToken) GetFieldValueAsync<T>(Int32, CancellationToken)

Ottiene in modo sincrono il valore della colonna specificata come tipo.Asynchronously gets the value of the specified column as a type.

(Inherited from DbDataReader)
GetFloat(Int32) GetFloat(Int32) GetFloat(Int32) GetFloat(Int32)

Ottiene il valore della colonna specificata come numero a virgola mobile con precisione singola.Gets the value of the specified column as a single-precision floating point number.

GetGuid(Int32) GetGuid(Int32) GetGuid(Int32) GetGuid(Int32)

Ottiene il valore della colonna specificata come identificatore univoco globale (GUID).Gets the value of the specified column as a globally-unique identifier (GUID).

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetInt16(Int32) GetInt16(Int32) GetInt16(Int32) GetInt16(Int32)

Ottiene il valore della colonna specificata sotto forma di intero con segno a 16 bit.Gets the value of the specified column as a 16-bit signed integer.

GetInt32(Int32) GetInt32(Int32) GetInt32(Int32) GetInt32(Int32)

Ottiene il valore della colonna specificata come intero con segno a 32 bit.Gets the value of the specified column as a 32-bit signed integer.

GetInt64(Int32) GetInt64(Int32) GetInt64(Int32) GetInt64(Int32)

Ottiene il valore della colonna specificata come integer con segno a 64 bit.Gets the value of the specified column as a 64-bit signed integer.

GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetName(Int32) GetName(Int32) GetName(Int32) GetName(Int32)

Ottiene il valore della colonna specificata sotto forma di classe String.Gets the value of the specified column as a String.

GetOrdinal(String) GetOrdinal(String) GetOrdinal(String) GetOrdinal(String)

Ottiene la posizione ordinale della colonna, dato il nome della colonna.Gets the column ordinal, given the name of the column.

GetProviderSpecificFieldType(Int32) GetProviderSpecificFieldType(Int32) GetProviderSpecificFieldType(Int32) GetProviderSpecificFieldType(Int32)

Ottiene il tipo della colonna specificata nel formato specifico del provider.Gets the type of the specified column in provider-specific format.

GetProviderSpecificValue(Int32) GetProviderSpecificValue(Int32) GetProviderSpecificValue(Int32) GetProviderSpecificValue(Int32)

Ottiene il valore della colonna specificata nel formato specifico del provider.Gets the value of the specified column in provider-specific format.

GetProviderSpecificValues(Object[]) GetProviderSpecificValues(Object[]) GetProviderSpecificValues(Object[]) GetProviderSpecificValues(Object[])

Riempie la matrice fornita con le informazioni sul tipo specifico del provider per tutte le colonne nella classe DataTableReader.Fills the supplied array with provider-specific type information for all the columns in the DataTableReader.

GetSchemaTable() GetSchemaTable() GetSchemaTable() GetSchemaTable()

Restituisce un oggetto DataTable che descrive i metadati della colonna di DataTableReader.Returns a DataTable that describes the column metadata of the DataTableReader.

GetStream(Int32) GetStream(Int32) GetStream(Int32) GetStream(Int32)

Recupera i dati come Stream.Retrieves data as a Stream.

(Inherited from DbDataReader)
GetString(Int32) GetString(Int32) GetString(Int32) GetString(Int32)

Ottiene il valore della colonna specificata sotto forma di stringa.Gets the value of the specified column as a string.

GetTextReader(Int32) GetTextReader(Int32) GetTextReader(Int32) GetTextReader(Int32)

Recupera i dati come TextReader.Retrieves data as a TextReader.

(Inherited from DbDataReader)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
GetValue(Int32) GetValue(Int32) GetValue(Int32) GetValue(Int32)

Ottiene il valore della colonna specificata nel formato nativo.Gets the value of the specified column in its native format.

GetValues(Object[]) GetValues(Object[]) GetValues(Object[]) GetValues(Object[])

Popola una matrice di oggetti con i valori della colonna della riga corrente.Populates an array of objects with the column values of the current row.

InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
IsDBNull(Int32) IsDBNull(Int32) IsDBNull(Int32) IsDBNull(Int32)

Ottiene un valore che indica se la colonna contiene valori non esistenti o mancanti.Gets a value that indicates whether the column contains non-existent or missing values.

IsDBNullAsync(Int32) IsDBNullAsync(Int32) IsDBNullAsync(Int32) IsDBNullAsync(Int32)

Versione asincrona di IsDBNull(Int32) che ottiene un valore che indica se la colonna contiene valori non esistenti o mancanti.An asynchronous version of IsDBNull(Int32), which gets a value that indicates whether the column contains non-existent or missing values.

(Inherited from DbDataReader)
IsDBNullAsync(Int32, CancellationToken) IsDBNullAsync(Int32, CancellationToken) IsDBNullAsync(Int32, CancellationToken) IsDBNullAsync(Int32, CancellationToken)

Versione asincrona di IsDBNull(Int32) che ottiene un valore che indica se la colonna contiene valori non esistenti o mancanti.An asynchronous version of IsDBNull(Int32), which gets a value that indicates whether the column contains non-existent or missing values. Invia facoltativamente una notifica di richiesta di annullamento delle operazioni.Optionally, sends a notification that operations should be cancelled.

(Inherited from DbDataReader)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
NextResult() NextResult() NextResult() NextResult()

Sposta la classe DataTableReader al gruppo di risultati successivo, se esistente.Advances the DataTableReader to the next result set, if any.

NextResultAsync() NextResultAsync() NextResultAsync() NextResultAsync()

Una versione asincrona di NextResult() che sposta il lettore sul risultato successivo durante la lettura dei risultati di un batch di istruzioni.An asynchronous version of NextResult(), which advances the reader to the next result when reading the results of a batch of statements.

Richiama NextResultAsync(CancellationToken) con CancellationToken.None.Invokes NextResultAsync(CancellationToken) with CancellationToken.None.

(Inherited from DbDataReader)
NextResultAsync(CancellationToken) NextResultAsync(CancellationToken) NextResultAsync(CancellationToken) NextResultAsync(CancellationToken)

Si tratta della versione asincrona di NextResult().This is the asynchronous version of NextResult(). I provider devono eseguire l'override con un'implementazione appropriata.Providers should override with an appropriate implementation. Il cancellationToken può facoltativamente essere ignorato.The cancellationToken may optionally be ignored.

L'implementazione predefinita richiama il metodo sincrono NextResult() e restituisce un'attività completata, bloccando il thread chiamante.The default implementation invokes the synchronous NextResult() method and returns a completed task, blocking the calling thread. L'implementazione predefinita restituirà un'attività annullata se viene passato un cancellationToken già annullato.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Le eccezioni generate da NextResult() verranno passate mediante la proprietà Task Exception restituita.Exceptions thrown by NextResult() will be communicated via the returned Task Exception property.

Non si devono richiamare altri metodi e proprietà dell'oggetto DbDataReader mentre l'attività restituita non è ancora completata.Other methods and properties of the DbDataReader object should not be invoked while the returned Task is not yet completed.

(Inherited from DbDataReader)
Read() Read() Read() Read()

Sposta l'oggetto DataTableReader al record successivo.Advances the DataTableReader to the next record.

ReadAsync() ReadAsync() ReadAsync() ReadAsync()

Versione asincrona di Read(), che avanza il lettore al record successivo di un set di risultati.An asynchronous version of Read(), which advances the reader to the next record in a result set. Questo metodo richiama ReadAsync(CancellationToken) con CancellationToken.None.This method invokes ReadAsync(CancellationToken) with CancellationToken.None.

(Inherited from DbDataReader)
ReadAsync(CancellationToken) ReadAsync(CancellationToken) ReadAsync(CancellationToken) ReadAsync(CancellationToken)

Si tratta della versione asincrona di Read().This is the asynchronous version of Read(). I provider devono eseguire l'override con un'implementazione appropriata.Providers should override with an appropriate implementation. Il token di annullamento può facoltativamente essere ignorato.The cancellationToken may optionally be ignored.

L'implementazione predefinita richiama il metodo sincrono Read() e restituisce un'attività completata, bloccando il thread chiamante.The default implementation invokes the synchronous Read() method and returns a completed task, blocking the calling thread. L'implementazione predefinita restituirà un'attività annullata se viene passato un cancellationToken già annullato.The default implementation will return a cancelled task if passed an already cancelled cancellationToken. Le eccezioni generate da Read verranno passate mediante la proprietà Task Exception restituita.Exceptions thrown by Read will be communicated via the returned Task Exception property.

Non richiamare altri metodi e proprietà dell'oggetto DbDataReader finché l'attività restituita non viene completata.Do not invoke other methods and properties of the DbDataReader object until the returned Task is complete.

(Inherited from DbDataReader)
ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Implementazioni dell'interfaccia esplicita

IDataReader.Close() IDataReader.Close() IDataReader.Close() IDataReader.Close() Inherited from DbDataReader
IDataReader.GetSchemaTable() IDataReader.GetSchemaTable() IDataReader.GetSchemaTable() IDataReader.GetSchemaTable() Inherited from DbDataReader
IDataRecord.GetData(Int32) IDataRecord.GetData(Int32) IDataRecord.GetData(Int32) IDataRecord.GetData(Int32)

Per una descrizione di questo membro, vedere GetData(Int32).For a description of this member, see GetData(Int32).

(Inherited from DbDataReader)

Extension Methods

CanGetColumnSchema(DbDataReader) CanGetColumnSchema(DbDataReader) CanGetColumnSchema(DbDataReader) CanGetColumnSchema(DbDataReader)

Ottiene un valore che indica se un oggetto DbDataReader può ottenere uno schema di colonna.Gets a value that indicates whether a DbDataReader can get a column schema.

GetColumnSchema(DbDataReader) GetColumnSchema(DbDataReader) GetColumnSchema(DbDataReader) GetColumnSchema(DbDataReader)

Ottiene lo schema di colonne (raccolta DbColumn) per un oggetto DbDataReader.Gets the column schema (DbColumn collection) for a DbDataReader.

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Consente la parallelizzazione di una query.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Converte un oggetto IEnumerable in un oggetto IQueryable.Converts an IEnumerable to an IQueryable.

Si applica a