SafeHandle.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.
Libère les ressources utilisées par la classe SafeHandle.
Surcharges
Dispose() |
Libère toutes les ressources utilisées par la classe SafeHandle. |
Dispose(Boolean) |
Libère les ressources non managées utilisées par la classe SafeHandle, en spécifiant s'il faut exécuter une opération de suppression normale. |
Dispose()
- Source:
- SafeHandle.cs
- Source:
- SafeHandle.cs
- Source:
- SafeHandle.cs
Libère toutes les ressources utilisées par la classe SafeHandle.
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. Cela peut ne pas se produire immédiatement si d’autres threads utilisent la même instance du handle sécurisé, mais cela se produit dès que ce n’est plus le cas. Bien que la plupart des classes utilisant SafeHandle n’aient pas besoin de fournir un finaliseur, cela est parfois nécessaire (par exemple, pour vider les mémoires tampons de fichiers ou réécrire des données en mémoire). Dans ce cas, ils peuvent fournir un finaliseur dont l’exécution est garantie avant l’exécution du SafeHandle finaliseur critique.
Appelez la Close méthode ou Dispose lorsque vous avez terminé d’utiliser l’objet SafeHandle . La Close méthode laisse l’objet SafeHandle dans un état inutilisable.
Notes
Appelez toujours la Close méthode ou Dispose avant de libérer votre dernière référence à l’objet SafeHandle . Sinon, les ressources utilisées ne seront pas libérées tant que le garbage collector n'aura pas appelé la méthode SafeHandle de l'objet Finalize.
S’applique à
Dispose(Boolean)
- Source:
- SafeHandle.cs
- Source:
- SafeHandle.cs
- Source:
- SafeHandle.cs
Libère les ressources non managées utilisées par la classe SafeHandle, 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
.