Control.Dispose Método

Definição

Permite que o controlo do servidor realize a limpeza final antes de ser libertado 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

Exemplos

O exemplo de código seguinte sobrepõe o Dispose método para fechar o HtmlTextWriter objeto associado a um controlo e chamar o Dispose método num Button controlo, chamado myButton. Se an Exception for lançado quando esta versão do Dispose método é chamada, o controlo escreve 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

Observações

Ligue Dispose quando terminar de usar o Control. O Dispose método deixa o Control num estado inutilizável. Depois de chamar este método, deve libertar todas as referências ao controlo para que a memória que ocupava possa ser recuperada pela recolha de lixo.

Aplica-se a

Ver também