CriticalHandle.Dispose Méthode

Définition

Espace de noms:

System.Runtime.InteropServices

Assembly:

mscorlib.dll

Marque le handle pour libérer et libérer des ressources.

Surcharges

Nom	Description
Dispose()	Libère toutes les ressources utilisées par le CriticalHandle.
Dispose(Boolean)	Libère les ressources non managées utilisées par la CriticalHandle classe spécifiant s’il faut effectuer une opération de suppression normale.

Dispose()

Libère toutes les ressources utilisées par le CriticalHandle.

public:
 virtual void Dispose();

public void Dispose();

abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit

Public Sub Dispose ()

Implémente

Dispose()

Remarques

L’appel de la méthode Dispose ou l’appel Close permet de libérer les ressources. Contrairement à la SafeHandle classe, cela se produit toujours immédiatement, car il n’existe aucun nombre de références pour indiquer que d’autres threads utilisent ce handle. Par conséquent, vous devez utiliser un mécanisme de synchronisation pour vous assurer qu’il est sûr d’appeler la Dispose méthode. Bien que la plupart des classes qui utilisent la CriticalHandle classe n’aient pas besoin de fournir un finaliseur, cela est parfois nécessaire (par exemple, pour vider les mémoires tampons de fichiers ou pour écrire des données en mémoire). Dans ce cas, la classe peut fournir un finaliseur garanti pour s’exécuter avant l’exécution du CriticalHandle finaliseur critique.

Appelez la ou Dispose la Close méthode lorsque vous avez terminé d’utiliser l’objetCriticalHandle. La Close méthode laisse l’objet CriticalHandle dans un état inutilisable.

Note Appelez toujours la ou Dispose la Close méthode avant de publier votre dernière référence à l’objetCriticalHandle. Sinon, les ressources qu’il utilise ne seront pas libérées tant que le garbage collector n’appelle pas la CriticalHandle méthode de l’objet Finalize .

Dispose(Boolean)

Libère les ressources non managées utilisées par la CriticalHandle classe spécifiant s’il faut effectuer une opération de suppression normale.

protected:
 virtual void Dispose(bool disposing);

[System.Security.SecurityCritical]
protected virtual void Dispose(bool disposing);

[<System.Security.SecurityCritical>]
abstract member Dispose : bool -> unit
override this.Dispose : bool -> unit

Protected Overridable Sub Dispose (disposing As Boolean)

Paramètres

disposing

Boolean

true pour une opération de suppression normale ; false pour finaliser le handle.

Attributs

SecurityCriticalAttribute

Remarques

Vous ne devez jamais appeler explicitement la Dispose méthode avec le disposing paramètre défini sur false.