Export (0) Print
Expand All

Control.Dispose Method

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)

public virtual void Dispose ()
public void Dispose ()
public function Dispose ()
Not applicable.

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 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 void Dispose()
{
    try {
        get_Context().get_Response().Write("Disposing " + ToString());

        // Perform resource cleanup.
        myTextWriter.Close();
        myButton.Dispose();
    }
    catch (System.Exception myException) {
        get_Context().get_Response().Write("Exception occurred: " 
            + myException.get_Message());
    }
} //Dispose

Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft