Control.Dispose Método

Definición

Espacio de nombres:

System.Web.UI

Ensamblado:

System.Web.dll

Habilita un control de servidor para que realice la limpieza final antes de que se libere de la memoria.

public:
 virtual void Dispose();

public virtual void Dispose ();

abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit

Public Overridable Sub Dispose ()

Implementaciones

Dispose()

Ejemplos

En el ejemplo de código siguiente se invalida el Dispose método para cerrar el HtmlTextWriter objeto asociado a un control y llamar al Dispose método en un Button control denominado myButton. Si se produce una Exception excepción cuando se llama a esta versión del Dispose método , el control escribe un mensaje en el objeto actual HttpResponse .

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

Comentarios

Llame a Dispose cuando haya terminado de usar Control. El método Dispose deja el Control en un estado no utilizable. Después de llamar a este método, debe liberar todas las referencias al control para que la recolección de elementos no utilizados pueda reclamar la memoria que ocupa.

Consulte también

• Introducción al ciclo de vida de la página de ASP.NET