Control.Dispose Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Enables a server control to perform final clean up before it is released from memory.
public:
virtual void Dispose();public virtual void Dispose ();abstract member Dispose : unit -> unit
override this.Dispose : unit -> unitPublic Overridable Sub Dispose ()Implements
Examples
The following code example overrides the Dispose method to close the HtmlTextWriter object associated with a control, and call the Dispose method on a Button control, named myButton. If an Exception is thrown when this version of the Dispose method is called, the control writes a message to the current HttpResponse object.
public override void Dispose()
{
try
{
Context.Response.Write("Disposing " + ToString());
// Perform resource cleanup.
myTextWriter.Close();
myButton.Dispose();
}
catch(Exception myException)
{
Context.Response.Write("Exception occurred: "+myException.Message);
}
}
Public Overrides Sub Dispose()
Try
Context.Response.Write("Disposing " & ToString())
' Perform resource cleanup.
myTextWriter.Close()
myButton.Dispose()
Catch myException As Exception
Context.Response.Write("Exception occurred: " & myException.Message)
End Try
End Sub
Remarks
Call Dispose when you are finished using the Control. The Dispose method leaves the Control in an unusable state. After calling this method, you must release all references to the control so the memory it was occupying can be reclaimed by garbage collection.
