Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

XmlDesigner.Dispose Method (Boolean)

This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.

Releases the unmanaged resources that are used by the XmlDesigner control and optionally releases the managed resources.

Namespace:  System.Web.UI.Design.WebControls
Assembly:  System.Design (in System.Design.dll)

protected override void Dispose(
	bool disposing


Type: System.Boolean

true to release both managed and unmanaged resources; false to release only unmanaged resources.

Call Dispose when you are finished using the XmlDesigner class. The Dispose method leaves the XmlDesigner in an unusable state. After calling Dispose, you must release all references to the XmlDesigner so the garbage collector can reclaim the memory that the XmlDesigner was occupying. For more information, see Cleaning Up Unmanaged Resources and Implementing a Dispose Method.


Always call Dispose before you release your last reference to the XmlDesigner. Otherwise, the resources it is using will not be freed until the garbage collector calls the XmlDesigner object's Finalize method.

The Dispose method is called by the public Dispose() method and the Finalize method. The Dispose() invokes the protected Dispose(Boolean) method with disposing set to true. The Finalize invokes Dispose with disposing set to false.

When disposing is true, the Dispose method releases all resources that are held by any managed objects that this XmlDesigner references. The Dispose method invokes the Dispose() method of each referenced object.

Notes to Inheritors

When overriding Dispose(Boolean), because the Dispose method can be called multiple times by other objects, be careful not to reference objects that have been previously disposed of in an earlier call to the Dispose method. For more information about how to implement Dispose(Boolean), see Implementing a Dispose Method

Overriding the Finalize Method

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1
© 2015 Microsoft