SqlCommand.ExecuteScalarAsync(CancellationToken) SqlCommand.ExecuteScalarAsync(CancellationToken) SqlCommand.ExecuteScalarAsync(CancellationToken) Method

Définition

Version asynchrone d’ExecuteScalar(), qui exécute la requête de façon asynchrone et retourne la première colonne de la première ligne du jeu de résultats retourné par la requête.An asynchronous version of ExecuteScalar(), which executes the query asynchronously and returns the first column of the first row in the result set returned by the query. Les colonnes ou lignes supplémentaires sont ignorées.Additional columns or rows are ignored.

Le jeton d'annulation peut être utilisé pour demander que l'opération soit abandonnée avant que le délai d'attente de commande s'écoule.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Les exceptions seront signalées via l’objet Task retourné.Exceptions will be reported via the returned Task object.

public:
 override System::Threading::Tasks::Task<System::Object ^> ^ ExecuteScalarAsync(System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.Task<object> ExecuteScalarAsync (System.Threading.CancellationToken cancellationToken);
override this.ExecuteScalarAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>

Paramètres

cancellationToken
CancellationToken CancellationToken CancellationToken

Instruction d'annulation.The cancellation instruction.

Retours

Tâche représentant l’opération asynchrone.A task representing the asynchronous operation.

Exceptions

Un SqlDbType autre que Binary ou VarBinary a été utilisé quand Value avait la valeur Stream.A SqlDbType other than Binary or VarBinary was used when Value was set to Stream. Pour plus d’informations sur le streaming, consultez Prise en charge du streaming pour SqlClient.For more information about streaming, see SqlClient Streaming Support.

ou-or-

Un SqlDbType autre que Char, NChar, NVarChar, VarChar ou Xml a été utilisé quand Value avait la valeur TextReader.A SqlDbType other than Char, NChar, NVarChar, VarChar, or Xml was used when Value was set to TextReader.

- ou --or-

Un SqlDbType autre que Xml a été utilisé quand Value avait la valeur XmlReader.A SqlDbType other than Xml was used when Value was set to XmlReader.

Appels multiples de ExecuteScalarAsync(CancellationToken) pour la même instance avant la fin de la tâche.Calling ExecuteScalarAsync(CancellationToken) more than once for the same instance before task completion.

- ou --or-

La SqlConnection a été fermée ou supprimée pendant une opération de diffusion en continu.The SqlConnection closed or dropped during a streaming operation. Pour plus d’informations sur le streaming, consultez Prise en charge du streaming pour SqlClient.For more information about streaming, see SqlClient Streaming Support.

- ou --or-

Context Connection=true est spécifié dans la chaîne de connexion.Context Connection=true is specified in the connection string.

SQL Server a retourné une erreur pendant l’exécution du texte de commande.SQL Server returned an error while executing the command text.

- ou --or-

Un délai d’attente a été dépassé pendant une opération de diffusion en continu.A timeout occurred during a streaming operation. Pour plus d’informations sur le streaming, consultez Prise en charge du streaming pour SqlClient.For more information about streaming, see SqlClient Streaming Support.

Une erreur s’est produite dans un objet Stream, XmlReader ou TextReader pendant une opération de diffusion en continu.An error occurred in a Stream, XmlReader or TextReader object during a streaming operation. Pour plus d’informations sur le streaming, consultez Prise en charge du streaming pour SqlClient.For more information about streaming, see SqlClient Streaming Support.

L’objet Stream, XmlReader ou TextReader a été fermé pendant une opération de diffusion en continu.The Stream, XmlReader or TextReader object was closed during a streaming operation. Pour plus d’informations sur le streaming, consultez Prise en charge du streaming pour SqlClient.For more information about streaming, see SqlClient Streaming Support.

Remarques

Pour plus d’informations sur la programmation asynchrone dans le Fournisseur de données .NET Framework pour SQL Server, consultez programmation asynchrone.For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

S’applique à

Voir aussi