Form.Close 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.
Fecha o formulário.
public:
void Close();
public void Close ();
member this.Close : unit -> unit
Public Sub Close ()
Exceções
O formulário foi fechado enquanto um identificador estava sendo criado.
Não é possível chamar esse método do evento Activated quando WindowState está definido como Maximized.
Comentários
Quando um formulário é fechado, todos os recursos criados dentro do objeto são fechados e o formulário é descartado. Você pode impedir o fechamento de um formulário em tempo de execução manipulando o Closing evento e definindo a Cancel propriedade do CancelEventArgs passado como um parâmetro para o manipulador de eventos. Se o formulário que você está fechando for a forma de inicialização do aplicativo, seu aplicativo terminará.
As duas condições em que um formulário não é descartado Close
é quando (1) ele faz parte de um aplicativo de MDI (interface de vários documentos) e o formulário não está visível; e (2) você exibiu o formulário usando ShowDialog. Nesses casos, você precisará chamar Dispose manualmente para marcar todos os controles do formulário para coleta de lixo.
Observação
Quando o Close método é chamado em um Form exibido como uma janela sem formatada, você não pode chamar o Show método para tornar o formulário visível, pois os recursos do formulário já foram liberados. Para ocultar um formulário e torná-lo visível, use o Control.Hide método .
Cuidado
Antes do .NET Framework 2.0, os Form.Closed eventos e Form.Closing não são gerados quando o Application.Exit método é chamado para sair do aplicativo. Se você tiver código de validação em qualquer um desses eventos que devem ser executados, deverá chamar o Form.Close método para cada formulário aberto individualmente antes de chamar o Exit método .