DbDataReader.ReadAsync Metodo

Definizione

Spazio dei nomi:

System.Data.Common

Assembly:

System.Data.Common.dll

Sposta in modo asincrono il lettore al record successivo in un set di risultati.

Overload

ReadAsync()	Sposta in modo asincrono il lettore al record successivo in un set di risultati.
ReadAsync(CancellationToken)	Sposta in modo asincrono il lettore al record successivo in un set di risultati.

Commenti

Per altre informazioni sulla programmazione asincrona, vedere Programmazione asincrona.

ReadAsync()

Source:

DbDataReader.cs

Sposta in modo asincrono il lettore al record successivo in un set di risultati.

public:
 System::Threading::Tasks::Task<bool> ^ ReadAsync();

public System.Threading.Tasks.Task<bool> ReadAsync ();

member this.ReadAsync : unit -> System.Threading.Tasks.Task<bool>

Public Function ReadAsync () As Task(Of Boolean)

Restituisce

Task<Boolean>

Task<TResult> la cui proprietà Result è true se sono presenti più righe o false in caso contrario.

Eccezioni

DbException

Errore che si è verificato durante l'esecuzione del testo del comando.

Commenti

L'implementazione predefinita di questo metodo asincrono richiama la controparte sincrona e restituisce un'attività completata, potenzialmente bloccando il thread chiamante.

I provider di dati che supportano la programmazione asincrona devono eseguire l'override dell'implementazione predefinita usando operazioni di I/O asincrone.

Non si devono richiamare altri metodi e proprietà dell'oggetto DbDataReader mentre l'attività restituita non è ancora completata.

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Read().

Vedi anche

• Panoramica di ADO.NET

ReadAsync(CancellationToken)

Source:

DbDataReader.cs

Sposta in modo asincrono il lettore al record successivo in un set di risultati.

public:
 virtual System::Threading::Tasks::Task<bool> ^ ReadAsync(System::Threading::CancellationToken cancellationToken);

public virtual System.Threading.Tasks.Task<bool> ReadAsync (System.Threading.CancellationToken cancellationToken);

abstract member ReadAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.ReadAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Overridable Function ReadAsync (cancellationToken As CancellationToken) As Task(Of Boolean)

Parametri

cancellationToken

CancellationToken

L'istruzione di annullamento.

Restituisce

Task<Boolean>

Task<TResult> la cui proprietà Result è true se sono presenti più righe o false in caso contrario.

Eccezioni

DbException

Errore che si è verificato durante l'esecuzione del testo del comando.

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

L'implementazione predefinita di questo metodo asincrono richiama la controparte sincrona e restituisce un'attività completata, potenzialmente bloccando il thread chiamante. L'implementazione predefinita restituisce anche un'attività annullata se è stato passato un token di annullamento già annullato.

I provider di dati che supportano la programmazione asincrona devono eseguire l'override dell'implementazione predefinita usando operazioni di I/O asincrone.

Questo metodo accetta un token di annullamento che può essere utilizzato per richiedere che l'operazione venga annullata in anticipo. Le implementazioni possono ignorare la richiesta.

Non si devono richiamare altri metodi e proprietà dell'oggetto DbDataReader mentre l'attività restituita non è ancora completata.

Questo metodo archivia nell'attività che restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Read().

Vedi anche

• Panoramica di ADO.NET