SafeHandle.Dispose Méthode

Définition

Libère les ressources utilisées par la classe SafeHandle.Releases the resources used by the SafeHandle class.

Surcharges

Dispose()

Libère toutes les ressources utilisées par la classe SafeHandle.Releases all resources used by the SafeHandle class.

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.Releases the unmanaged resources used by the SafeHandle class specifying whether to perform a normal dispose operation.

Dispose()

Libère toutes les ressources utilisées par la classe SafeHandle.Releases all resources used by the SafeHandle class.

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 Close de Dispose la méthode ou permet de libérer les ressources.Calling the Close or Dispose method allows the resources to be freed. 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.This might not happen immediately if other threads are using the same instance of the safe handle, but will happen as soon as that is no longer the case. Bien que la plupart SafeHandle des classes utilisant 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).Although most classes using SafeHandle do not need to provide a finalizer, this is sometimes necessary (for example, to flush out file buffers or to write some data back into memory). Dans ce cas, ils peuvent fournir un finaliseur qui est garanti pour s’exécuter avant SafeHandle l’exécution du finaliseur critique.In this case, they can provide a finalizer that is guaranteed to run before the SafeHandle critical finalizer runs.

Appelez la Close méthode Dispose ou lorsque vous avez fini d’utiliser SafeHandle l’objet.Call the Close or Dispose method when you are finished using the SafeHandle object. La Close méthode laisse l' SafeHandle objet dans un état inutilisable.The Close method leaves the SafeHandle object in an unusable state.

Notes

Appelez toujours la Close méthode Dispose ou avant de libérer votre dernière référence à l' SafeHandle objet.Always call the Close or Dispose method before you release your last reference to the SafeHandle object. 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.Otherwise, the resources it is using will not be freed until the garbage collector calls the SafeHandle object's Finalize method.

Sécurité

SecurityPermission
pour obtenir l’autorisation d’appeler du code non managé.for permission to call unmanaged code. Action de sécurité LinkDemand:.Security action: LinkDemand. Énumération associée:UnmanagedCodeAssociated enumeration: UnmanagedCode

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.Releases the unmanaged resources used by the SafeHandle class specifying whether to perform a normal dispose operation.

protected:
 virtual void Dispose(bool disposing);
[System.Security.SecurityCritical]
protected virtual void Dispose (bool disposing);
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.true for a normal dispose operation; false to finalize the handle.

Attributs

Remarques

Vous ne devez jamais appeler explicitement Dispose la méthode avec disposing le paramètre défini falsesur.You should never explicitly call the Dispose method with the disposing parameter set to false.

Sécurité

SecurityPermission
pour obtenir l’autorisation d’appeler du code non managé.for permission to call unmanaged code. Action de sécurité LinkDemand:.Security action: LinkDemand. Énumération associée:UnmanagedCodeAssociated enumeration: UnmanagedCode

S’applique à