Control.Dispose Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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);
}
}
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 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.