Form.Close Método

Definição

Fecha o formulário.Closes the form.

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.The form was closed while a handle was being created.

Não é possível chamar esse método do evento Activated quando WindowState está definido como Maximized.You cannot call this method from the Activated event when WindowState is set to Maximized.

Comentários

Quando um formulário é fechado, todos os recursos criados dentro do objeto são fechados e o formulário é Descartado.When a form is closed, all resources created within the object are closed and the form is disposed. Você pode evitar o fechamento de um formulário em tempo de execução manipulando o evento Closing e definindo a propriedade Cancel do CancelEventArgs passado como um parâmetro para o manipulador de eventos.You can prevent the closing of a form at run time by handling the Closing event and setting the Cancel property of the CancelEventArgs passed as a parameter to your event handler. Se o formulário que você está fechando for a forma de inicialização do seu aplicativo, o aplicativo será encerrado.If the form you are closing is the startup form of your application, your application ends.

As duas condições quando um formulário não é Descartado em Close é quando (1) faz parte de um aplicativo de interface de vários documentos (MDI), e o formulário não é visível; e (2) você exibiu o formulário usando ShowDialog.The two conditions when a form is not disposed on Close is when (1) it is part of a multiple-document interface (MDI) application, and the form is not visible; and (2) you have displayed the form using ShowDialog. Nesses casos, será necessário chamar Dispose manualmente para marcar todos os controles do formulário para a coleta de lixo.In these cases, you will need to call Dispose manually to mark all of the form's controls for garbage collection.

Observação

Quando o método de Close é chamado em um Form exibido como uma janela não-restrita, você não pode chamar o método Show para tornar o formulário visível, pois os recursos do formulário já foram liberados.When the Close method is called on a Form displayed as a modeless window, you cannot call the Show method to make the form visible, because the form's resources have already been released. Para ocultar um formulário e torná-lo visível, use o método Control.Hide.To hide a form and then make it visible, use the Control.Hide method.

Cuidado

Antes do .NET Framework.NET Framework 2,0, os eventos Form.Closed e Form.Closing não são gerados quando o método Application.Exit é chamado para sair do aplicativo.Prior to the .NET Framework.NET Framework 2.0, the Form.Closed and Form.Closing events are not raised when the Application.Exit method is called to exit your application. Se você tiver código de validação em qualquer um desses eventos que deve ser executado, chame o método Form.Close para cada formulário aberto individualmente antes de chamar o método Exit.If you have validation code in either of these events that must be executed, you should call the Form.Close method for each open form individually before calling the Exit method.

Aplica-se a

Veja também