DbCommand.ExecuteNonQueryAsync 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.
Questo metodo implementa la versione asincrona di ExecuteNonQuery(), ma restituisce in Task modo sincrono, bloccando il thread chiamante.
Overload
| Nome | Descrizione |
|---|---|
| ExecuteNonQueryAsync(CancellationToken) |
Si tratta della versione asincrona di ExecuteNonQuery(). 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 ExecuteNonQuery() 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 ExecuteNonQuery() verranno comunicate tramite la proprietà Task Exception restituita. Non richiamare altri metodi e proprietà dell'oggetto |
| ExecuteNonQueryAsync() |
Versione asincrona di ExecuteNonQuery(), che esegue il comando sul relativo oggetto connessione, restituendo il numero di righe interessate. ExecuteNonQueryAsync(CancellationToken) Richiama con CancellationToken.None. |
Commenti
Per altre informazioni sulla programmazione asincrona, vedere Programmazione asincrona.
ExecuteNonQueryAsync(CancellationToken)
Si tratta della versione asincrona di ExecuteNonQuery(). 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 ExecuteNonQuery() 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 ExecuteNonQuery() 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<int> ^ ExecuteNonQueryAsync(System::Threading::CancellationToken cancellationToken);public virtual System.Threading.Tasks.Task<int> ExecuteNonQueryAsync(System.Threading.CancellationToken cancellationToken);abstract member ExecuteNonQueryAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>
override this.ExecuteNonQueryAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>Public Overridable Function ExecuteNonQueryAsync (cancellationToken As CancellationToken) As Task(Of Integer)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 ExecuteNonQuery().
Vedi anche
Si applica a
ExecuteNonQueryAsync()
Versione asincrona di ExecuteNonQuery(), che esegue il comando sul relativo oggetto connessione, restituendo il numero di righe interessate.
ExecuteNonQueryAsync(CancellationToken) Richiama con CancellationToken.None.
public:
System::Threading::Tasks::Task<int> ^ ExecuteNonQueryAsync();public System.Threading.Tasks.Task<int> ExecuteNonQueryAsync();member this.ExecuteNonQueryAsync : unit -> System.Threading.Tasks.Task<int>Public Function ExecuteNonQueryAsync () As Task(Of Integer)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 ExecuteNonQuery().