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 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
- Quelle:
- CriticalHandle.cs
- 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
Hinweise
Durch Aufrufen der Close -Methode oder Dispose können die Ressourcen freigegeben werden. Im Gegensatz zur -Klasse geschieht dies SafeHandle immer sofort, da es keine Verweisanzahl gibt, die angibt, dass andere Threads dieses Handle verwenden. Daher müssen Sie einen Synchronisierungsmechanismus verwenden, um sicherzustellen, dass es 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 - 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 auf, Dispose 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.
Gilt für:
Dispose(Boolean)
- Quelle:
- CriticalHandle.cs
- Quelle:
- CriticalHandle.cs
- 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);
[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:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für