Control.Dispose Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.