SafeHandle.Dispose Methode

Definition

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

Überlädt

Dispose()

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

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()

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

Durch Aufrufen Close der Dispose -Methode oder der-Methode können die Ressourcen freigegeben werden.Calling the Close or Dispose method allows the resources to be freed. Dies geschieht möglicherweise nicht sofort, wenn andere Threads dieselbe Instanz des sicheren Handles verwenden, aber so bald, wie 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 , die verwenden, keinen Finalizer bereitstellen müssen, ist dies manchmal erforderlich (z. b. zum leeren der Datei Puffer oder zum Zurückschreiben von Daten in den Arbeitsspeicher).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 bereitstellen, der vor der Ausführung des SafeHandle kritischen Finalizers garantiert ausgeführt wird.In this case, they can provide a finalizer that is guaranteed to run before the SafeHandle critical finalizer runs.

Wenn Sie Close die Dispose Verwendung des SafeHandle -Objekts abgeschlossen haben, können Sie die-oder die-MethodeCall the Close or Dispose method when you are finished using the SafeHandle object. Die Close -Methode lässt SafeHandle das-Objekt in einen nicht verwendbaren Zustand.The Close method leaves the SafeHandle object in an unusable state.

Hinweis

Ruft immer die Close - Dispose oder-Methode auf, bevor Sie den letzten SafeHandle Verweis auf das-Objekt freigeben.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 Abrufen von nicht verwaltetem Code.for permission to call unmanaged code. Sicherheitsaktion: LinkDemand.Security action: LinkDemand. Zugehörige Enumeration:UnmanagedCodeAssociated enumeration: UnmanagedCode

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

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

Attribute

Hinweise

Sie sollten die Dispose -Methode niemals explizit aufrufen, disposing wenn der- falseParameter auf festgelegt ist.You should never explicitly call the Dispose method with the disposing parameter set to false.

Sicherheit

SecurityPermission
für die Berechtigung zum Abrufen von nicht verwaltetem Code.for permission to call unmanaged code. Sicherheitsaktion: LinkDemand.Security action: LinkDemand. Zugehörige Enumeration:UnmanagedCodeAssociated enumeration: UnmanagedCode

Gilt für: