Share via


XmlDesigner.Dispose(Boolean) Methode

Definition

Gibt die vom XmlDesigner-Steuerelement verwendeten nicht verwalteten Ressourcen und optional auch die verwalteten Ressourcen frei.

Diese API unterstützt die Produktinfrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code gedacht.

protected:
 override void Dispose(bool disposing);
protected override void Dispose (bool disposing);
override this.Dispose : bool -> unit
Protected Overrides 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.

Hinweise

Rufen Sie auf Dispose , wenn Sie mit der XmlDesigner -Klasse fertig sind. Die Dispose-Methode bewirkt, dass XmlDesigner nicht mehr verwendet werden kann. Nachdem Sie aufgerufen Disposehaben, müssen Sie alle Verweise auf den XmlDesigner freigeben, damit der Garbage Collector den Arbeitsspeicher, den der XmlDesigner belegt hat, zurückgewinnen kann. Weitere Informationen finden Sie unter Bereinigen nicht verwalteter Ressourcen und Implementieren einer Dispose-Methode.

Hinweis

Rufen Sie immer Dispose auf, bevor Sie den letzten Verweis auf das XmlDesigner freigeben. Andernfalls bleiben die verwendeten Ressourcen reserviert, bis die Garbage Collection die XmlDesigner-Methode des Finalize-Objekts aufruft.

Die Dispose Methode wird von der öffentlichen Dispose() Methode und der Finalize() -Methode aufgerufen, wenn sie überschrieben wurde. Ruft Dispose() die geschützte Dispose(Boolean) Methode auf, wobei disposing auf festgelegt ist true. Der Finalize gibt den disposing Parameter als falsean.

Wenn disposing ist, gibt truedie Dispose -Methode alle Ressourcen frei, die von allen verwalteten Objekten gespeichert werden, auf die diese XmlDesigner verweist. Die Dispose -Methode ruft die Dispose() -Methode jedes Objekts auf, auf das verwiesen wird.

Hinweise für Vererber

Achten Sie beim Überschreiben Dispose(Boolean), da die Dispose Methode von anderen Objekten mehrmals aufgerufen werden kann, nicht auf Objekte zu verweisen, die zuvor in einem früheren Aufruf der Dispose -Methode entfernt wurden. Weitere Informationen zur Implementierung Dispose(Boolean)finden Sie unter Implementieren einer Dispose-Methode.

Überschreiben der Finalize-Methode

Gilt für:

Weitere Informationen