DbConnection.OpenAsync Méthode

Définition

Espace de noms:

System.Data.Common

Assembly:

System.Data.Common.dll

Cette méthode implémente une version asynchrone de Open().

Surcharges

OpenAsync()

Version asynchrone de Open(), qui ouvre une connexion de base de données avec les paramètres spécifiés par ConnectionString. Cette méthode appelle la méthode virtuelle OpenAsync(CancellationToken) avec CancellationToken.None.

OpenAsync(CancellationToken)

Il s'agit de la version asynchrone de Open(). Les fournisseurs doivent effectuer le remplacement avec une implémentation appropriée. Le jeton d'annulation peut éventuellement être respecté. L'implémentation par défaut appelle l'appel de méthode Open() synchrone et retourne une tâche terminée. L'implémentation par défaut retourne une tâche annulée si un cancellationToken déjà annulé est passé. Les exceptions levées par Open sont communiquées via la propriété d'exception de tâche retournée. N'appelle pas d'autres méthodes et propriétés de l'objet DbConnection jusqu'à ce que la tâche retournée soit terminée.

Remarques

Pour plus d’informations sur la programmation asynchrone dans le fournisseur de données .NET Framework pour SQL Server, consultez Programmation asynchrone.

OpenAsync()

Source:

DbConnection.cs

Version asynchrone de Open(), qui ouvre une connexion de base de données avec les paramètres spécifiés par ConnectionString. Cette méthode appelle la méthode virtuelle OpenAsync(CancellationToken) avec CancellationToken.None.

public:
 System::Threading::Tasks::Task ^ OpenAsync();

public System.Threading.Tasks.Task OpenAsync ();

member this.OpenAsync : unit -> System.Threading.Tasks.Task

Public Function OpenAsync () As Task

Retours

Task

Tâche représentant l’opération asynchrone.

Remarques

Après avoir appelé OpenAsync, State doit retourner Connecting jusqu’à ce que le retourné 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 tente d’annuler ou de fermer l’appel correspondant OpenAsync .

Pour plus d’informations sur la programmation asynchrone dans le fournisseur de données .NET Framework pour SQL Server, consultez Programmation asynchrone.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le é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 manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par Open().

Voir aussi

• Vue d'ensemble d’ADO.NET

OpenAsync(CancellationToken)

Source:

DbConnection.cs

Il s'agit de la version asynchrone de Open(). Les fournisseurs doivent effectuer le remplacement avec une implémentation appropriée. Le jeton d'annulation peut éventuellement être respecté.

L'implémentation par défaut appelle l'appel de méthode Open() synchrone et retourne une tâche terminée. L'implémentation par défaut retourne une tâche annulée si un cancellationToken déjà annulé est passé. Les exceptions levées par Open sont communiquées via la propriété d'exception de tâche retournée.

N'appelle pas d'autres méthodes et propriétés de l'objet DbConnection jusqu'à ce que la tâche retournée soit 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.Task

Public Overridable Function OpenAsync (cancellationToken As CancellationToken) As Task

Paramètres

cancellationToken

CancellationToken

Instruction d'annulation.

Retours

Task

Tâche représentant l’opération asynchrone.

Exceptions

OperationCanceledException

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

Remarques

Après avoir appelé OpenAsync, State doit retourner Connecting jusqu’à ce que le retourné 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 tente d’annuler ou de fermer l’appel correspondant OpenAsync .

Pour plus d’informations sur la programmation asynchrone dans le fournisseur de données .NET Framework pour SQL Server, consultez Programmation asynchrone.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le é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 manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par Open().

Voir aussi

• Vue d'ensemble d’ADO.NET