CriticalHandle.Dispose Methode

Definition

Markiert das Handle zum Freigeben und Freigeben von Ressourcen.

Überlädt

Name Beschreibung
Dispose()

Veröffentlicht alle ressourcen, die von der CriticalHandle.

Dispose(Boolean)

Gibt die von der Klasse verwendeten nicht verwalteten Ressourcen frei, die CriticalHandle angeben, ob ein normaler Dispose-Vorgang ausgeführt werden soll.

Dispose()

Veröffentlicht alle ressourcen, die von der CriticalHandle.

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 können Dispose die Ressourcen freigegeben werden. SafeHandle Im Gegensatz zur Klasse erfolgt dies immer sofort, da keine Referenzanzahl vorhanden ist, um anzugeben, dass andere Threads dieses Handle verwenden. Daher müssen Sie einen Synchronisierungsmechanismus verwenden, um sicherzustellen, dass sie sicher ist, die Dispose Methode aufzurufen. 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 Methode auf Dispose , wenn Sie mit der Verwendung des CriticalHandle Objekts fertig sind. Die Close Methode verlässt das CriticalHandle Objekt in einem nicht verwendbaren Zustand.

Hinweis Rufen Sie immer die Close Methode auf, Dispose bevor Sie den letzten Verweis auf das CriticalHandle Objekt freigeben. Andernfalls werden die verwendeten Ressourcen erst freigegeben, wenn der Garbage Collector die Methode des CriticalHandleFinalize Objekts aufruft.

Gilt für:

Dispose(Boolean)

Gibt die von der Klasse verwendeten nicht verwalteten Ressourcen frei, die CriticalHandle angeben, ob ein normaler Dispose-Vorgang 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 Entsorgungsvorgang; false zum Abschließen des Handles.

Attribute

Hinweise

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

Gilt für: