DbBatch.ExecuteScalarAsync(CancellationToken) Metodo

Definizione

Spazio dei nomi:

System.Data.Common

Assembly:

System.Data.Common.dll

Origine:

DbBatch.cs

Versione asincrona di ExecuteScalar(), che esegue il batch 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.

public abstract System.Threading.Tasks.Task<object?> ExecuteScalarAsync (System.Threading.CancellationToken cancellationToken = default);

abstract member ExecuteScalarAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>

Public MustOverride Function ExecuteScalarAsync (Optional cancellationToken As CancellationToken = Nothing) As Task(Of Object)

Parametri

cancellationToken

CancellationToken

Token per annullare l'operazione asincrona.

Restituisce

Task<Object>

Prima colonna della prima riga del primo set di risultati.

Eccezioni

DbException

Errore durante l'esecuzione del batch.

OperationCanceledException

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

Commenti

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().