Component.Dispose Methode

Definition

Gibt die von der Component verwendeten Ressourcen frei.Releases the resources used by the Component.

Überlädt

Dispose()

Gibt alle vom Component verwendeten Ressourcen frei.Releases all resources used by the Component.

Dispose(Boolean)

Gibt die von Component verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

Dispose()

Gibt alle vom Component verwendeten Ressourcen frei.Releases all resources used by the Component.

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

Implementiert

Hinweise

Rufen Sie Dispose auf, wenn Sie Component nicht mehr benötigen.Call Dispose when you are finished using the Component. Die Dispose-Methode bewirkt, dass Component nicht mehr verwendet werden kann.The Dispose method leaves the Component in an unusable state. Nach dem DisposeAufrufen von müssen Sie alle Verweise auf den Component freigeben, damit der Garbage Collector den Speicher freigeben kann Component , den der belegt hat.After calling Dispose, you must release all references to the Component so the garbage collector can reclaim the memory that the Component was occupying. Weitere Informationen finden Sie unter Bereinigen von nicht verwalteten Ressourcen und Implementieren einerverwerfen-Methode.For more information, see Cleaning Up Unmanaged Resources and Implementing a Dispose Method.

Hinweis

Rufen Sie immer Dispose auf, bevor Sie den letzten Verweis auf das Component freigeben.Always call Dispose before you release your last reference to the Component. Andernfalls bleiben die verwendeten Ressourcen reserviert, bis die Garbage Collection die Component-Methode des Finalize-Objekts aufruft.Otherwise, the resources it is using will not be freed until the garbage collector calls the Component object's Finalize method.

Siehe auch

Dispose(Boolean)

Gibt die von Component verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

protected:
 virtual void Dispose(bool disposing);
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, um sowohl verwaltete als auch nicht verwaltete Ressourcen freizugeben, false, um ausschließlich nicht verwaltete Ressourcen freizugeben.true to release both managed and unmanaged resources; false to release only unmanaged resources.

Hinweise

Diese Methode wird von der öffentlichen Dispose -Methode und der Finalize -Methode aufgerufen.This method is called by the public Dispose method and the Finalize method. Dispose()Ruft die geschützte Dispose(Boolean) Methode auf, disposing wobei der- trueParameter auf festgelegt ist.Dispose() invokes the protected Dispose(Boolean) method with the disposing parameter set to true. FinalizeRuft Dispose auf disposing , wobei falseauf gesetzt ist.Finalize invokes Dispose with disposing set to false.

Wenn der disposing-Parameter true ist, gibt diese Methode sämtliche Ressourcen frei, die für verwaltete Objekte reserviert sind, auf die dieser Component verweist.When the disposing parameter is true, this method releases all resources held by any managed objects that this Component references. Diese Methode ruft die Dispose()-Methode aller Objekte auf, auf die verwiesen wird.This method invokes the Dispose() method of each referenced object.

Hinweise für Vererber

Dispose kann von anderen Objekten mehrmals aufgerufen werden. Dispose can be called multiple times by other objects. Beim Überschreiben von Dispose(Boolean) müssen Sie darauf achten, nicht auf Objekte zu verweisen, die durch einen früheren Aufruf von Dispose freigegeben wurden.When overriding Dispose(Boolean), be careful not to reference objects that have been previously disposed of in an earlier call to Dispose. Weitere Informationen zum Implementieren Dispose(Boolean)von finden Sie unter [Implementieren einer](~/docs/standard/garbage-collection/implementing-dispose.md)verwerfen-Methode.For more information about how to implement Dispose(Boolean), see [Implementing a Dispose Method](~/docs/standard/garbage-collection/implementing-dispose.md). Weitere Informationen zu und Dispose Finalize()finden Sie unter [Bereinigen von nicht verwalteten Ressourcen](~/docs/standard/garbage-collection/unmanaged.md) und überschreiben [der Finalize-Methode](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/ddae83kx(v=vs.100)).For more information about Dispose and Finalize(), see [Cleaning Up Unmanaged Resources](~/docs/standard/garbage-collection/unmanaged.md) and [Overriding the Finalize Method](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/ddae83kx(v=vs.100)).

Gilt für: