CriticalHandle.Dispose Methode

Definition

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.dll

Markiert das Handle für das Freigeben und Verfügbarmachen von Ressourcen.

Überlädt

Dispose()	Gibt alle vom CriticalHandle verwendeten Ressourcen frei.
Dispose(Boolean)	Gibt die von der CriticalHandle-Klasse verwendeten, nicht verwalteten Ressourcen frei und gibt an, ob ein normaler Freigabevorgang ausgeführt werden soll.

Dispose()

Quelle:

CriticalHandle.cs

Gibt alle vom CriticalHandle verwendeten Ressourcen frei.

public:
 virtual void Dispose();

public void Dispose ();

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

Public Sub Dispose ()

Implementiert

Dispose()

Hinweise

Wenn Sie die Close -Methode oder Dispose aufrufen, können die Ressourcen freigegeben werden. Im Gegensatz zur -Klasse geschieht dies SafeHandle immer sofort, da keine Verweisanzahl vorhanden ist, um anzugeben, dass andere Threads dieses Handle verwenden. Daher müssen Sie einen Synchronisierungsmechanismus verwenden, um sicherzustellen, dass die Dispose -Methode sicher aufgerufen werden kann. Obwohl die meisten Klassen, die die CriticalHandle -Klasse verwenden, 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 kann die -Klasse einen Finalizer bereitstellen, der garantiert ausgeführt wird, bevor der CriticalHandle kritische Finalizer ausgeführt wird.

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

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

Dispose(Boolean)

Quelle:

CriticalHandle.cs

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

protected:
 virtual void Dispose(bool disposing);

protected virtual void Dispose (bool disposing);

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.

Hinweise

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