Control.Dispose Control.Dispose Control.Dispose Control.Dispose Method

Definición

Habilita un control de servidor para que realice la limpieza final antes de que se libere de la memoria.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 -> unit
Public Overridable Sub Dispose ()

Implementaciones

Ejemplos

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

Comentarios

Llame a Dispose cuando haya terminado de usar Control.Call Dispose when you are finished using the Control. El método Dispose deja el Control en un estado no utilizable.The Dispose method leaves the Control in an unusable state. Después de llamar a este método, debe liberar todas las referencias al control, por lo que la recolección de elementos no utilizados puede reclamar la memoria que ocupaba.After calling this method, you must release all references to the control so the memory it was occupying can be reclaimed by garbage collection.

Se aplica a

Consulte también: