Form.Close Метод

Определение

Закрывает форму.Closes the form.

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

Исключения

Форма была закрыта при создании дескриптора.The form was closed while a handle was being created.

Нельзя вызывать этот метод из события Activated, если свойство WindowState задано как Maximized.You cannot call this method from the Activated event when WindowState is set to Maximized.

Комментарии

При закрытии формы все ресурсы, созданные в объекте, закрываются, и форма удаляется.When a form is closed, all resources created within the object are closed and the form is disposed. Можно предотвратить закрытие формы во время выполнения, обрабатывая событие Closing и установив свойство Cancel CancelEventArgs, передаваемое в качестве параметра обработчику событий.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. Если закрываемая форма является начальной формой приложения, приложение завершается.If the form you are closing is the startup form of your application, your application ends.

Два условия, когда форма не удаляется на Close, — когда (1) она является частью приложения с многодокументным интерфейсом (MDI), а форма не отображается; и (2) форма была отображена с помощью 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. В таких случаях необходимо вручную вызвать Dispose, чтобы пометить все элементы управления формы для сборки мусора.In these cases, you will need to call Dispose manually to mark all of the form's controls for garbage collection.

Примечание

При вызове метода Close в Form, отображаемом в виде немодального окна, нельзя вызвать метод Show, чтобы сделать форму видимой, так как ресурсы формы уже были освобождены.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. Чтобы скрыть форму и сделать ее видимой, используйте метод Control.Hide.To hide a form and then make it visible, use the Control.Hide method.

Внимание!

До .NET Framework.NET Framework 2,0 события Form.Closed и Form.Closing не вызываются при вызове метода Application.Exit для выхода из приложения.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. При наличии кода проверки в любом из этих событий, которые необходимо выполнить, следует вызывать метод Form.Close для каждой открытой формы по отдельности перед вызовом метода 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.

Применяется к

Дополнительно