CriticalHandle.Dispose 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.
Marque le handle pour libérer des ressources.
Surcharges
Dispose() |
Libère toutes les ressources utilisées par CriticalHandle. |
Dispose(Boolean) |
Libère les ressources non managées utilisées par la classe CriticalHandle, en spécifiant s'il faut exécuter une opération de suppression normale. |
Dispose()
- Source:
- CriticalHandle.cs
- Source:
- CriticalHandle.cs
- Source:
- CriticalHandle.cs
Libère toutes les ressources utilisées par CriticalHandle.
public:
virtual void Dispose();
public void Dispose ();
abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit
Public Sub Dispose ()
Implémente
Remarques
L’appel de la Close méthode ou Dispose 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 réécrire des données dans la mémoire). Dans ce cas, la classe peut fournir un finaliseur dont l’exécution est garantie avant l’exécution du CriticalHandle finaliseur critique.
Appelez la Close méthode ou Dispose lorsque vous avez terminé d’utiliser l’objet CriticalHandle . La Close méthode laisse l’objet CriticalHandle dans un état inutilisable.
Note Appelez toujours la Close méthode ou Dispose avant de libérer votre dernière référence à l’objet CriticalHandle . Sinon, les ressources utilisées ne seront pas libérées tant que le garbage collector n'aura pas appelé la méthode CriticalHandle de l'objet Finalize.
S’applique à
Dispose(Boolean)
- Source:
- CriticalHandle.cs
- Source:
- CriticalHandle.cs
- Source:
- CriticalHandle.cs
Libère les ressources non managées utilisées par la classe CriticalHandle, en spécifiant s'il faut exécuter une opération de suppression normale.
protected:
virtual void Dispose(bool disposing);
[System.Security.SecurityCritical]
protected virtual void Dispose (bool disposing);
protected virtual void Dispose (bool disposing);
[<System.Security.SecurityCritical>]
abstract member Dispose : bool -> unit
override this.Dispose : bool -> unit
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
Remarques
Vous ne devez jamais appeler explicitement la Dispose méthode avec le disposing
paramètre défini sur false
.