Ler em inglês

Compartilhar via


Control.Dispose Método

Definição

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

public virtual void Dispose();

Implementações

Exemplos

O exemplo de código a seguir substitui o Dispose método para fechar o objeto associado a HtmlTextWriter um controle e chamar o Dispose método em um Button controle chamado myButton. Se um Exception for gerado 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);
   }
}

Comentários

Chame Dispose quando terminar de usar o Control. O Dispose método deixa o Control em um 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

Produto Versões
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Confira também