Form.Close Form.Close Form.Close Form.Close Method

Definición

Cierra el formulario.Closes the form.

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

Excepciones

El formulario se ha cerrado mientras se creaba un identificador.The form was closed while a handle was being created.

No puede llamar a este método desde el evento Activated cuando WindowState se establece en Maximized.You cannot call this method from the Activated event when WindowState is set to Maximized.

Comentarios

Cuando se cierra un formulario, se cierran todos los recursos creados dentro del objeto y se desecha el formulario.When a form is closed, all resources created within the object are closed and the form is disposed. Para evitar el cierre de un formulario en tiempo de ejecución, controle Closing el evento y establezca Cancel la propiedad del CancelEventArgs pasado como un parámetro en el controlador 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. Si el formulario que va a cerrar es el formulario de inicio de la aplicación, la aplicación finaliza.If the form you are closing is the startup form of your application, your application ends.

Las dos condiciones en Close las que un formulario no se desecha es cuando (1) forma parte de una aplicación de interfaz de múltiples documentos (MDI) y el formulario no está visible; y (2) ha mostrado el formulario mediante. ShowDialogThe 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. En estos casos, tendrá que llamar Dispose a manualmente para marcar todos los controles del formulario para la recolección de elementos no utilizados.In these cases, you will need to call Dispose manually to mark all of the form's controls for garbage collection.

Nota

Cuando se llama al Form Show método en un que se muestra como una ventana no modal, no se puede llamar al método para hacer que el formulario sea visible, ya que los recursos del formulario ya se han liberado. CloseWhen 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 un formulario y, a continuación, hacer que esté Control.Hide visible, use el método.To hide a form and then make it visible, use the Control.Hide method.

Precaución

Antes del .NET Framework.NET Framework 2,0, los Form.Closed eventos y Form.Closing no se generan cuando Application.Exit se llama al método para salir de la aplicación.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. Si tiene código de validación en cualquiera de estos eventos que se debe ejecutar, debe llamar al Form.Close método para cada formulario abierto individualmente antes de llamar al Exit método.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.

Se aplica a

Consulte también: