SafeHandle.Dispose SafeHandle.Dispose SafeHandle.Dispose SafeHandle.Dispose Method

Definition

Gibt die von der SafeHandle-Klasse verwendeten Ressourcen frei.Releases the resources used by the SafeHandle class.

Überlädt

Dispose() Dispose() Dispose() Dispose()

Gibt alle von der SafeHandle-Klasse verwendeten Ressourcen frei.Releases all resources used by the SafeHandle class.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Gibt die von der SafeHandle-Klasse verwendeten, nicht verwalteten Ressourcen frei und gibt an, ob ein normaler Freigabevorgang ausgeführt werden soll.Releases the unmanaged resources used by the SafeHandle class specifying whether to perform a normal dispose operation.

Dispose() Dispose() Dispose() Dispose()

Gibt alle von der SafeHandle-Klasse verwendeten Ressourcen frei.Releases all resources used by the SafeHandle class.

public:
 virtual void Dispose();
public void Dispose ();
abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit
Public Sub Dispose ()

Implementiert

Hinweise

Aufrufen der Close oder Dispose Methode kann die Ressourcen freigegeben werden.Calling the Close or Dispose method allows the resources to be freed. Dies möglicherweise nicht sofort ausgeführt, wenn andere Threads dieselbe Instanz von SafeHandle verwenden, aber es erfolgt, sobald Sie dies nicht mehr der Fall ist.This might not happen immediately if other threads are using the same instance of the safe handle, but will happen as soon as that is no longer the case. Obwohl die meisten Klassen SafeHandle müssen Sie sich nicht um einen Finalizer bereitstellen, dies ist manchmal notwendig ist (z. B. Dateipuffer leeren oder um die Daten zurück in den Arbeitsspeicher zu schreiben).Although most classes using SafeHandle do not need to provide a finalizer, this is sometimes necessary (for example, to flush out file buffers or to write some data back into memory). In diesem Fall können sie einen Finalizer, der garantiert ist, führen Sie vor dem Bereitstellen der SafeHandle kritischen Finalizer ausgeführt wird.In this case, they can provide a finalizer that is guaranteed to run before the SafeHandle critical finalizer runs.

Rufen Sie die Close oder Dispose Methode, wenn Sie fertig sind mit den SafeHandle Objekt.Call the Close or Dispose method when you are finished using the SafeHandle object. Die Close -Methode bewirkt, dass die SafeHandle Objekt in einem nicht verwendbaren Zustand.The Close method leaves the SafeHandle object in an unusable state.

Hinweis

Rufen Sie immer die Close oder Dispose Methode, die bereits vor der Veröffentlichung des letzten Verweis auf die SafeHandle Objekt.Always call the Close or Dispose method before you release your last reference to the SafeHandle object. Andernfalls bleiben die verwendeten Ressourcen reserviert, bis die Garbage Collection die SafeHandle-Methode des Finalize-Objekts aufruft.Otherwise, the resources it is using will not be freed until the garbage collector calls the SafeHandle object's Finalize method.

Sicherheit

SecurityPermission
für die Berechtigung zum Aufrufen von nicht verwalteten Codes.for permission to call unmanaged code. Sicherheitsaktion: LinkDemand.Security action: LinkDemand. Zugeordnete Enumeration: UnmanagedCodeAssociated enumeration: UnmanagedCode

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Gibt die von der SafeHandle-Klasse verwendeten, nicht verwalteten Ressourcen frei und gibt an, ob ein normaler Freigabevorgang ausgeführt werden soll.Releases the unmanaged resources used by the SafeHandle class specifying whether to perform a normal dispose operation.

protected:
 virtual void Dispose(bool disposing);
[System.Security.SecurityCritical]
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 Boolean Boolean Boolean

true für einen normalen Freigabevorgang, false, um das Handle zu beenden.true for a normal dispose operation; false to finalize the handle.

Hinweise

Sie sollten niemals explizit aufrufen, die Dispose -Methode mit dem disposing Parametersatz zu false.You should never explicitly call the Dispose method with the disposing parameter set to false.

Sicherheit

SecurityPermission
für die Berechtigung zum Aufrufen von nicht verwalteten Codes.for permission to call unmanaged code. Sicherheitsaktion: LinkDemand.Security action: LinkDemand. Zugeordnete Enumeration: UnmanagedCodeAssociated enumeration: UnmanagedCode

Gilt für: