SafeHandle.Dispose Methode

Definition

Gibt die von der SafeHandle-Klasse verwendeten Ressourcen frei.

Überlädt

Dispose()

Gibt alle von der SafeHandle-Klasse verwendeten Ressourcen frei.

Dispose(Boolean)

Gibt die von der SafeHandle-Klasse verwendeten, nicht verwalteten Ressourcen frei und gibt an, ob ein normaler Freigabevorgang ausgeführt werden soll.

Dispose()

Gibt alle von der SafeHandle-Klasse verwendeten Ressourcen frei.

public:
 virtual void Dispose();
public void Dispose ();
abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit
Public Sub Dispose ()

Implementiert

Hinweise

Durch Aufrufen der Close -Methode oder Dispose können die Ressourcen freigegeben werden. Dies geschieht möglicherweise nicht sofort, wenn andere Threads dieselbe Instanz des sicheren Handle verwenden, aber sobald dies nicht mehr der Fall ist. Obwohl die meisten Klassen, die verwenden SafeHandle , keinen Finalizer bereitstellen müssen, ist dies manchmal erforderlich (z. B. zum Leeren von Dateipuffern oder zum Zurückschreiben einiger Daten in den Arbeitsspeicher). In diesem Fall können sie einen Finalizer bereitstellen, der garantiert ausgeführt wird, bevor der SafeHandle kritische Finalizer ausgeführt wird.

Rufen Sie die Close - oder Dispose -Methode auf, wenn Sie mit der Verwendung des SafeHandle -Objekts fertig sind. Die Close -Methode belässt das SafeHandle Objekt in einem nicht verwendbaren Zustand.

Hinweis

Rufen Sie immer die Close -Methode oder auf, Dispose bevor Sie Den letzten Verweis auf das SafeHandle -Objekt freigeben. Andernfalls bleiben die verwendeten Ressourcen reserviert, bis die Garbage Collection die SafeHandle-Methode des Finalize-Objekts aufruft.

Gilt für

Dispose(Boolean)

Gibt die von der SafeHandle-Klasse verwendeten, nicht verwalteten Ressourcen frei und gibt an, ob ein normaler Freigabevorgang ausgeführt werden soll.

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)

Parameter

disposing
Boolean

true für einen normalen Freigabevorgang, false, um das Handle zu beenden.

Attribute

Hinweise

Sie sollten die Dispose -Methode niemals explizit aufrufen, wobei der disposing Parameter auf festgelegt ist false.

Gilt für