Enables a server control to perform final clean up before it is released from memory.
Namespace:
System.Web.UI
Assembly:
System.Web (in System.Web.dll)
Visual Basic (Declaration)
Public Overridable Sub Dispose
Dim instance As Control
instance.Dispose()
public virtual void Dispose()
public:
virtual void Dispose()
public function Dispose()
Implements
IDisposable..::.Dispose()()()
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.
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 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
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);
}
}
Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
.NET Framework
Supported in: 3.5, 3.0, 2.0, 1.1, 1.0
Reference
Other Resources