DbCommand.ExecuteScalarAsync Metodo
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.
Implementa la versione asincrona di ExecuteScalar(), ma restituisce in Task modo sincrono, bloccando il thread chiamante.
Overload
| Nome | Descrizione |
|---|---|
| ExecuteScalarAsync() |
Versione asincrona di ExecuteScalar(), che esegue il comando e restituisce la prima colonna della prima riga del primo set di risultati restituito. Tutte le altre colonne, righe e set di risultati vengono ignorate. ExecuteScalarAsync(CancellationToken) Richiama con CancellationToken.None. |
| ExecuteScalarAsync(CancellationToken) |
Si tratta della versione asincrona di ExecuteScalar(). I provider devono eseguire l'override con un'implementazione appropriata. Facoltativamente, il token di annullamento può essere ignorato. L'implementazione predefinita richiama il metodo sincrono ExecuteScalar() e restituisce un'attività completata, bloccando il thread chiamante. L'implementazione predefinita restituirà un'attività annullata se è stato passato un token di annullamento già annullato. Le eccezioni generate da ExecuteScalar verranno comunicate tramite la proprietà Task Exception restituita. Non richiamare altri metodi e proprietà dell'oggetto |
Commenti
Per altre informazioni sulla programmazione asincrona, vedere Programmazione asincrona.
ExecuteScalarAsync()
Versione asincrona di ExecuteScalar(), che esegue il comando e restituisce la prima colonna della prima riga del primo set di risultati restituito. Tutte le altre colonne, righe e set di risultati vengono ignorate.
ExecuteScalarAsync(CancellationToken) Richiama con CancellationToken.None.
public:
System::Threading::Tasks::Task<System::Object ^> ^ ExecuteScalarAsync();public System.Threading.Tasks.Task<object> ExecuteScalarAsync();member this.ExecuteScalarAsync : unit -> System.Threading.Tasks.Task<obj>Public Function ExecuteScalarAsync () As Task(Of Object)Valori restituiti
Attività che rappresenta l'operazione asincrona.
Eccezioni
Errore durante l'esecuzione del comando.
Commenti
Per altre informazioni sulla programmazione asincrona, vedere Programmazione asincrona.
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 ExecuteScalar().
Vedi anche
Si applica a
ExecuteScalarAsync(CancellationToken)
Si tratta della versione asincrona di ExecuteScalar(). I provider devono eseguire l'override con un'implementazione appropriata. Facoltativamente, il token di annullamento può essere ignorato.
L'implementazione predefinita richiama il metodo sincrono ExecuteScalar() e restituisce un'attività completata, bloccando il thread chiamante. L'implementazione predefinita restituirà un'attività annullata se è stato passato un token di annullamento già annullato. Le eccezioni generate da ExecuteScalar verranno comunicate tramite la proprietà Task Exception restituita.
Non richiamare altri metodi e proprietà dell'oggetto DbCommand fino al completamento dell'attività restituita.
public:
virtual System::Threading::Tasks::Task<System::Object ^> ^ ExecuteScalarAsync(System::Threading::CancellationToken cancellationToken);public virtual System.Threading.Tasks.Task<object> ExecuteScalarAsync(System.Threading.CancellationToken cancellationToken);abstract member ExecuteScalarAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>
override this.ExecuteScalarAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>Public Overridable Function ExecuteScalarAsync (cancellationToken As CancellationToken) As Task(Of Object)Parametri
- cancellationToken
- CancellationToken
Token per annullare l'operazione asincrona.
Valori restituiti
Attività che rappresenta l'operazione asincrona.
Eccezioni
Errore durante l'esecuzione del comando.
Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.
Commenti
Per altre informazioni sulla programmazione asincrona, vedere Programmazione asincrona.
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 ExecuteScalar().