SafeHandle.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.
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()
- Quelle:
- SafeHandle.cs
- Quelle:
- SafeHandle.cs
- Quelle:
- SafeHandle.cs
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 -> unitPublic 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 unbrauchbaren 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)
- Quelle:
- SafeHandle.cs
- Quelle:
- SafeHandle.cs
- Quelle:
- SafeHandle.cs
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 -> unitabstract member Dispose : bool -> unit
override this.Dispose : bool -> unitProtected 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.
