Partager via


SqlBatch.ExecuteScalarAsync(CancellationToken) Méthode

Définition

Version asynchrone de ExecuteScalar(), qui exécute le lot et retourne la première colonne de la première ligne du premier jeu de résultats retourné. Toutes les autres colonnes, lignes et jeux de résultats sont ignorés.

public override System.Threading.Tasks.Task<object> ExecuteScalarAsync (System.Threading.CancellationToken cancellationToken = default);
override this.ExecuteScalarAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>
Public Overrides Function ExecuteScalarAsync (Optional cancellationToken As CancellationToken = Nothing) As Task(Of Object)

Paramètres

cancellationToken
CancellationToken

Jeton pour annuler l’opération asynchrone.

Retours

Première colonne de la première ligne du premier jeu de résultats.

Exceptions

Une erreur s’est produite lors de l’exécution du lot.

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

Cette méthode bénéficie de ExecuteScalarAsync(CancellationToken), et toutes les exceptions attendues de cette méthode s’appliquent également ici. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone.

S’applique à