CriticalHandle.Dispose Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.