SqlConnection.OpenAsync(CancellationToken) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Version asynchrone de , qui ouvre une connexion de base de données avec les paramètres de Open()propriété spécifiés par le ConnectionString. Le jeton d’annulation peut être utilisé pour demander que l’opération soit abandonnée avant l’expiration du délai d’expiration de la connexion. Les exceptions sont propagées via la tâche retournée. Si le délai d’expiration de la connexion s’écoule sans se connecter correctement, la tâche retournée est marquée comme étant défectueuse avec une exception. L’implémentation retourne une tâche sans bloquer le thread appelant pour les connexions mises en pool et non mises en pool.
public:
override System::Threading::Tasks::Task ^ OpenAsync(System::Threading::CancellationToken cancellationToken);public override System.Threading.Tasks.Task OpenAsync(System.Threading.CancellationToken cancellationToken);override this.OpenAsync : System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overrides Function OpenAsync (cancellationToken As CancellationToken) As TaskParamètres
- cancellationToken
- CancellationToken
Instruction d’annulation.
Retours
Tâche représentant l’opération asynchrone.
Exceptions
Appel OpenAsync(CancellationToken) plusieurs fois pour la même instance avant la fin de la tâche.
Context Connection=true est spécifié dans le chaîne de connexion.
Une connexion n’a pas été disponible à partir du pool de connexions avant l’expiration du délai d’expiration de la connexion.
Toute erreur retournée par SQL Server qui s’est produite lors de l’ouverture de la connexion.
Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.
Remarques
Une fois l’appel effectué OpenAsync, State doit retourner Connecting jusqu’à ce que le retour Task soit terminé. Ensuite, si la connexion a réussi, State doit retourner Open. Si la connexion échoue, State doit retourner Closed.
Un appel à Close tentera d’annuler ou de fermer l’appel correspondant OpenAsync .
Pour plus d’informations sur la programmation asynchrone dans .NET Framework Fournisseur de données pour SQL Server, consultez Asynchronous Programming.
Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’équivalent synchrone de la méthode peut lever. 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 façon synchrone. Pour les exceptions stockées, consultez les exceptions levées par Open().