DbConnection.OpenAsync 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.
Cette méthode implémente une version asynchrone de Open().
Surcharges
| Nom | Description |
|---|---|
| OpenAsync() |
Version asynchrone de , qui ouvre une connexion de base de Open()données avec les paramètres spécifiés par le ConnectionString. Cette méthode appelle la méthode OpenAsync(CancellationToken) virtuelle avec CancellationToken.None. |
| OpenAsync(CancellationToken) |
Il s’agit de la version asynchrone de Open(). Les fournisseurs doivent remplacer par une implémentation appropriée. Le jeton d’annulation peut éventuellement être honoré. L’implémentation par défaut appelle l’appel synchrone Open() et retourne une tâche terminée. L’implémentation par défaut retourne une tâche annulée si elle a passé une annulation d’annulationToken. Les exceptions levées par Open seront communiquées via la propriété Exception de tâche retournée. N’appelez pas d’autres méthodes et propriétés de l’objet |
Remarques
Pour plus d’informations sur la programmation asynchrone dans .NET Framework Fournisseur de données pour SQL Server, consultez Asynchronous Programming.
OpenAsync()
Version asynchrone de , qui ouvre une connexion de base de Open()données avec les paramètres spécifiés par le ConnectionString. Cette méthode appelle la méthode OpenAsync(CancellationToken) virtuelle avec CancellationToken.None.
public:
System::Threading::Tasks::Task ^ OpenAsync();public System.Threading.Tasks.Task OpenAsync();member this.OpenAsync : unit -> System.Threading.Tasks.TaskPublic Function OpenAsync () As TaskRetours
Tâche représentant l’opération asynchrone.
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().
Voir aussi
S’applique à
OpenAsync(CancellationToken)
Il s’agit de la version asynchrone de Open(). Les fournisseurs doivent remplacer par une implémentation appropriée. Le jeton d’annulation peut éventuellement être honoré.
L’implémentation par défaut appelle l’appel synchrone Open() et retourne une tâche terminée. L’implémentation par défaut retourne une tâche annulée si elle a passé une annulation d’annulationToken. Les exceptions levées par Open seront communiquées via la propriété Exception de tâche retournée.
N’appelez pas d’autres méthodes et propriétés de l’objet DbConnection tant que la tâche retournée n’est pas terminée.
public:
virtual System::Threading::Tasks::Task ^ OpenAsync(System::Threading::CancellationToken cancellationToken);public virtual System.Threading.Tasks.Task OpenAsync(System.Threading.CancellationToken cancellationToken);abstract member OpenAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.OpenAsync : System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overridable Function OpenAsync (cancellationToken As CancellationToken) As TaskParamètres
- cancellationToken
- CancellationToken
Instruction d’annulation.
Retours
Tâche représentant l’opération asynchrone.
Exceptions
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().