Form::Close Method ()
Closes the form.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
| Exception | Condition |
|---|---|
| InvalidOperationException | The form was closed while a handle was being created. |
| ObjectDisposedException | 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. 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.
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. In these cases, you will need to call Dispose manually to mark all of the form's controls for garbage collection.
Note |
|---|
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. To hide a form and then make it visible, use the Control::Hide method. |
Caution |
|---|
Prior to the .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. 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. |
Available since 1.1

