SafeHandle.Dispose Metodo

Definizione

Spazio dei nomi:

System.Runtime.InteropServices

Assembly:

mscorlib.dll

Rilascia le risorse usate dalla SafeHandle classe .

Overload

Nome	Descrizione
Dispose()	Rilascia tutte le risorse usate dalla SafeHandle classe .
Dispose(Boolean)	Rilascia le risorse non gestite usate dalla SafeHandle classe specificando se eseguire un'operazione dispose normale.

Dispose()

Rilascia tutte le risorse usate dalla SafeHandle classe .

public:
 virtual void Dispose();

public void Dispose();

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

Public Sub Dispose ()

Implementazioni

Dispose()

Commenti

La chiamata al Close metodo o Dispose consente di liberare le risorse. Ciò potrebbe non verificarsi immediatamente se altri thread usano la stessa istanza dell'handle sicuro, ma si verificherà non appena questo non è più il caso. Anche se la maggior parte delle classi che usano SafeHandle non è necessario fornire un finalizzatore, questa operazione è talvolta necessaria (ad esempio, per scaricare buffer di file o per scrivere alcuni dati in memoria). In questo caso, possono fornire un finalizzatore garantito per l'esecuzione prima dell'esecuzione del SafeHandle finalizzatore critico.

Chiamare il Close metodo o Dispose al termine dell'utilizzo dell'oggetto SafeHandle . Il Close metodo lascia l'oggetto SafeHandle in uno stato inutilizzabile.

Note

Chiamare sempre il Close metodo o Dispose prima di rilasciare l'ultimo riferimento all'oggetto SafeHandle . In caso contrario, le risorse in uso non verranno liberate finché il Garbage Collector non chiamerà il SafeHandle metodo dell'oggetto Finalize .

Dispose(Boolean)

Rilascia le risorse non gestite usate dalla SafeHandle classe specificando se eseguire un'operazione dispose 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)

Parametri

disposing

Boolean

true per un'operazione di eliminazione normale; false per finalizzare l'handle.

Attributi

SecurityCriticalAttribute

Commenti

Non chiamare mai in modo esplicito il Dispose metodo con il disposing parametro impostato su false.