Form.Close Método

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Fecha o formulário.

public:
 void Close();
public void Close ();
member this.Close : unit -> unit
Public Sub Close ()

Exceções

InvalidOperationException

O formulário foi fechado enquanto um identificador estava sendo criado.

ObjectDisposedException

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 .

Aplica-se a

Confira também