Control.Dispose Método

  • Referência

Definição

Namespace:
System.Web.UI
Assembly:
System.Web.dll

Permite que um controle de servidor execute a limpeza final antes do lançamento da memória.

public:
 virtual void Dispose();
public virtual void Dispose ();
abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit
Public Overridable Sub Dispose ()

Implementações

Dispose()

Exemplos

O exemplo de código a seguir substitui o Dispose método para fechar o HtmlTextWriter objeto associado a um controle e chamar o Dispose método em um Button controle, chamado myButton. Se uma Exception versão do método for lançada quando essa versão do Dispose método for chamada, o controle gravará uma mensagem no objeto atual 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

Comentários

Chame Dispose quando terminar de usar o Control. O Dispose método deixa o Control estado inutilizável. Depois de chamar esse método, você deve liberar todas as referências ao controle para que a memória que ele estava ocupando possa ser recuperada pela coleta de lixo.

Aplica-se a

Confira também