DbConnection.CloseAsync Méthode

Définition

Ferme de manière asynchrone la connexion à la base de données.

public:
 virtual System::Threading::Tasks::Task ^ CloseAsync();
public virtual System.Threading.Tasks.Task CloseAsync ();
abstract member CloseAsync : unit -> System.Threading.Tasks.Task
override this.CloseAsync : unit -> System.Threading.Tasks.Task
Public Overridable Function CloseAsync () As Task

Retours

Task

Task représentant l’opération asynchrone.

Remarques

L’implémentation par défaut de cette méthode asynchrone délègue à son homologue synchrone et retourne un terminé Task , bloquant potentiellement le thread appelant.

Les fournisseurs de données qui prennent en charge la programmation asynchrone doivent remplacer l’implémentation par défaut à l’aide d’opérations d’e/s asynchrones.

Les Close CloseAsync méthodes et annulent toutes les transactions en attente. Ils libèrent ensuite la connexion au pool de connexions ou ferment la connexion si le regroupement de connexions est désactivé.

Une application peut appeler Close ou CloseAsync plusieurs fois. Aucune exception n’est générée.

Si le DbConnection est hors de portée, il n’est pas fermé. Par conséquent, vous devez fermer explicitement la connexion en appelant Close ou Dispose , qui sont fonctionnellement équivalents. Si la valeur Pooling de regroupement de connexions est définie true sur ou yes , la connexion physique est également libérée.

Attention

Ne fermez pas ou ne supprimez pas un DbConnection , un DbDataReader ou tout autre objet managé dans la Finalize méthode de votre classe. Dans un finaliseur, vous ne devez libérer que les ressources non managées que votre classe possède directement. Si votre classe ne possède pas de ressource non managée, n'incluez pas une méthode Finalize dans la définition de classe. Pour plus d’informations, consultez Nettoyage de la mémoire.

S’applique à