EntityDataReader Classe

Definizione

Spazio dei nomi:

System.Data.EntityClient

Assembly:

System.Data.Entity.dll

Legge un flusso di righe forward-only da un'origine dati.

public ref class EntityDataReader : System::Data::Common::DbDataReader, System::Data::IExtendedDataRecord

public class EntityDataReader : System.Data.Common.DbDataReader, System.Data.IExtendedDataRecord

type EntityDataReader = class
    inherit DbDataReader
    interface IExtendedDataRecord
    interface IDataRecord

Public Class EntityDataReader
Inherits DbDataReader
Implements IExtendedDataRecord

Ereditarietà

Object

MarshalByRefObject

DbDataReader

EntityDataReader

Implementazioni

IDataRecord IExtendedDataRecord

Commenti

Combina la funzionalità della classe DbDataReader e dell'interfaccia IExtendedDataRecord.

Un oggetto EntityDataReader non include alcun costruttore pubblico, Può essere ottenuto solo tramite uno degli overload del EntityCommand.ExecuteReader metodo.

Tramite SQL Server i parametri di output delle stored procedure vengono inseriti alla fine del flusso di risultati, dopo tutti i set di risultati. Per ottenere i valori dei parametri di output è pertanto necessario che un'applicazione utilizzi tutti i record in tutti i set di risultati. Se EntityDataReader viene chiuso dall'applicazione, con la conseguente chiusura anche di DbDataReader, i parametri di output potrebbero non venire popolati.

EntityDataReader non utilizza in modo implicito i set di risultati per rendere disponibili i parametri di output. Si noti pertanto quanto segue:

• EntityDataReader chiama DbDataReader.NextResult solo quando EntityDataReader.NextResult viene chiamato in modo esplicito. Se DbDataReader.NextResult genera un'eccezione, l'oggetto verrà eseguito il EntityDataReader wrapping in una (o in un'eccezione EntityException derivata).

• Close consente esclusivamente di chiudere DbDataReader, senza utilizzare i set di risultati o i record in sospeso.

• Dispose consente esclusivamente di eliminare DbDataReader, senza utilizzare i set di risultati o i record in sospeso.

Per esempi di codice, vedere Uso di EntityClient.

Proprietà

DataRecordInfo	Ottiene DataRecordInfo per l'oggetto IExtendedDataRecord.
Depth	Ottiene un valore che indica il livello di annidamento della riga corrente.
FieldCount	Ottiene il numero di colonne nella riga corrente.
HasRows	Ottiene un valore che indica se EntityDataReader contiene una o più righe.
IsClosed	Ottiene un valore che indica se l'oggetto EntityDataReader è chiuso.
Item[Int32]	Ottiene il valore della colonna specificata come istanza di Object.
Item[String]	Ottiene il valore della colonna specificata come istanza di Object.
RecordsAffected	Ottiene il numero di righe modificate, inserite o eliminate dall'esecuzione dell'istruzione SQL.
VisibleFieldCount	Ottiene il numero di campi non nascosti in EntityDataReader.

Metodi

Close()	Chiude l'oggetto EntityDataReader.
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 utilizzate da EntityDataReader e chiama Close().
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 come valore Boolean.
GetByte(Int32)	Ottiene il valore della colonna specificata come byte.
GetBytes(Int32, Int64, Byte[], Int32, Int32)	Legge un flusso di byte dalla colonna specificata, partendo dalla posizione indicata da dataIndex e, nel buffer, partendo dalla posizione indicata da bufferIndex.
GetChar(Int32)	Ottiene il valore della colonna specificata come carattere singolo.
GetChars(Int32, Int64, Char[], Int32, Int32)	Legge un flusso di caratteri dalla colonna specificata, partendo dalla posizione indicata da dataIndex e, nel buffer, partendo dalla posizione indicata da bufferIndex.
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)
GetDataReader(Int32)	Restituisce lettori annidati come oggetti DbDataReader.
GetDataRecord(Int32)	Restituisce un oggetto DbDataRecord annidato.
GetDataTypeName(Int32)	Ottiene il nome del 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.
GetDecimal(Int32)	Ottiene il valore della colonna specificata come oggetto Decimal.
GetDouble(Int32)	Ottiene il valore della colonna specificata come numero a virgola mobile a precisione doppia.
GetEnumerator()	Restituisce un oggetto IEnumerator che può essere utilizzato per scorrere le righe nel lettore di dati.
GetFieldType(Int32)	Ottiene il tipo di dati della colonna specificata.
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 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()	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 nome della colonna quando viene specificato l'ordinale di colonna in base zero.
GetOrdinal(String)	Ottiene l'ordinale di colonna, dato il nome della colonna.
GetProviderSpecificFieldType(Int32)	Restituisce il tipo di campo specifico del provider per la colonna indicata.
GetProviderSpecificValue(Int32)	Ottiene il valore della colonna specificata come istanza di Object.
GetProviderSpecificValues(Object[])	Ottiene tutte le colonne attributo specifiche del provider nella raccolta per la riga corrente.
GetSchemaTable()	Restituisce un oggetto DataTable che descrive i metadati della colonna di DbDataReader.
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 come istanza di String.
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 come istanza di Object.
GetValues(Object[])	Popola una matrice di oggetti con i valori della 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 non esistenti o mancanti.
IsDBNullAsync(Int32, CancellationToken)	Ottiene un valore in modo asincrono, che indica se la colonna contiene valori non esistenti o mancanti. (Ereditato da DbDataReader)
IsDBNullAsync(Int32)	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 il lettore al risultato successivo durante la lettura dei risultati di un batch di istruzioni.
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 lettore al record successivo in un gruppo di risultati.
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.
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.