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 Task in modo sincrono, bloccando il thread chiamante.
Overload
| ExecuteScalarAsync() |
Versione asincrona di ExecuteScalar(), che esegue il comando e restituisce la prima colonna della prima riga nel primo set di risultati restituito. Tutte le altre colonne, righe e set di risultati vengono ignorate. Richiama ExecuteScalarAsync(CancellationToken) con CancellationToken.None. |
| ExecuteScalarAsync(CancellationToken) |
Si tratta della versione asincrona di ExecuteScalar(). I provider devono eseguire l'override con un'implementazione appropriata. Il token di annullamento può facoltativamente 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 viene passato un token di annullamento già annullato. Le eccezioni generate da ExecuteScalar verranno passate mediante la proprietà Task Exception restituita. Non richiamare altri metodi e proprietà dell'oggetto |
Commenti
Per altre informazioni sulla programmazione asincrona, vedere Programmazione asincrona.
ExecuteScalarAsync()
- Source:
- DbCommand.cs
- Source:
- DbCommand.cs
- Source:
- DbCommand.cs
Versione asincrona di ExecuteScalar(), che esegue il comando e restituisce la prima colonna della prima riga nel primo set di risultati restituito. Tutte le altre colonne, righe e set di risultati vengono ignorate.
Richiama ExecuteScalarAsync(CancellationToken) con CancellationToken.None.
public:
System::Threading::Tasks::Task<System::Object ^> ^ ExecuteScalarAsync();public System.Threading.Tasks.Task<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)Restituisce
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à 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)
- Source:
- DbCommand.cs
- Source:
- DbCommand.cs
- Source:
- DbCommand.cs
Si tratta della versione asincrona di ExecuteScalar(). I provider devono eseguire l'override con un'implementazione appropriata. Il token di annullamento può facoltativamente 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 viene passato un token di annullamento già annullato. Le eccezioni generate da ExecuteScalar verranno passate mediante la proprietà Task Exception restituita.
Non richiamare altri metodi e proprietà dell'oggetto DbCommand finché l'attività restituita non viene completata.
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);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.
Restituisce
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à 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().
