Form.Close Método

  • Referencia

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

Cierra el formulario.

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

Excepciones

InvalidOperationException

El formulario se ha cerrado mientras se creaba un identificador.

ObjectDisposedException

No puede llamar a este método desde el evento Activated cuando WindowState se establece en Maximized.

Comentarios

Cuando se cierra un formulario, se cierran todos los recursos creados en el objeto y se elimina el formulario. Puede evitar el cierre de un formulario en tiempo de ejecución controlando el Closing evento y estableciendo la Cancel propiedad del CancelEventArgs pasado como parámetro al controlador de eventos. Si el formulario que está cerrando es el formulario de inicio de la aplicación, la aplicación finaliza.

Las dos condiciones en las que un formulario no se elimina Close es cuando (1) forma parte de una aplicación de interfaz de varios documentos (MDI) y el formulario no está visible; y (2) ha mostrado el formulario mediante ShowDialog. En estos casos, deberá llamar Dispose manualmente para marcar todos los controles del formulario para la recolección de elementos no utilizados.

Nota

Cuando se llama al Close método en una Form ventana mostrada como modelo, no puede llamar al Show método para que el formulario sea visible, ya que los recursos del formulario ya se han liberado. Para ocultar un formulario y, a continuación, hacer que sea visible, use el Control.Hide método .

Precaución

Antes de .NET Framework 2.0, los Form.Closed eventos y Form.Closing no se generan cuando se llama al método para salir de la Application.Exit aplicación. Si tiene código de validación en cualquiera de estos eventos que se deben ejecutar, debe llamar al Form.Close método para cada formulario abierto individualmente antes de llamar al Exit método .

Se aplica a

Consulte también