Form.FormClosing Evento

Definizione

Si verifica prima della chiusura del form.Occurs before the form is closed.

public:
 event System::Windows::Forms::FormClosingEventHandler ^ FormClosing;
public event System.Windows.Forms.FormClosingEventHandler FormClosing;
member this.FormClosing : System.Windows.Forms.FormClosingEventHandler 
Public Custom Event FormClosing As FormClosingEventHandler 

Tipo evento

FormClosingEventHandler

Esempio

Nell'esempio seguente viene illustrato l'utilizzo di questo membro.The following example demonstrates the use of this member. Nell'esempio, un gestore eventi segnala l'occorrenza dell' FormClosing evento.In the example, an event handler reports on the occurrence of the FormClosing event. Questo report consente di apprendere quando si verifica l'evento e può facilitare il debug.This report helps you to learn when the event occurs and can assist you in debugging. Per creare report su più eventi o sugli eventi che si verificano di frequente, provare MessageBox.Show a sostituire con Console.WriteLine o ad accodare il messaggio a una riga TextBox .To report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

Per eseguire il codice di esempio, incollarlo in un progetto che contiene un'istanza di tipo Form denominata Form1 .To run the example code, paste it into a project that contains an instance of type Form named Form1. Assicurarsi quindi che il gestore eventi sia associato all' FormClosing evento.Then ensure that the event handler is associated with the FormClosing event.

private void Form1_FormClosing(Object sender, FormClosingEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "CloseReason", e.CloseReason );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Cancel", e.Cancel );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "FormClosing Event" );
}
Private Sub Form1_FormClosing(sender as Object, e as FormClosingEventArgs) _ 
     Handles Form1.FormClosing

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "CloseReason", e.CloseReason)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Cancel", e.Cancel)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"FormClosing Event")

End Sub

Commenti

L' FormClosing evento si verifica durante la chiusura del modulo.The FormClosing event occurs as the form is being closed. Quando un modulo viene chiuso, viene eliminato, rilasciando tutte le risorse associate al modulo.When a form is closed, it is disposed, releasing all resources associated with the form. Se si annulla questo evento, il form rimane aperto.If you cancel this event, the form remains opened. Per annullare la chiusura di un form, impostare la Cancel proprietà dell'oggetto FormClosingEventArgs passato al gestore eventi su true .To cancel the closure of a form, set the Cancel property of the FormClosingEventArgs passed to your event handler to true.

Quando un form viene visualizzato come finestra di dialogo modale, facendo clic sul pulsante Chiudi (il pulsante con una X nell'angolo superiore destro del form) il form viene nascosto e la DialogResult proprietà viene impostata su DialogResult.Cancel .When a form is displayed as a modal dialog box, clicking the Close button (the button with an X at the upper-right corner of the form) causes the form to be hidden and the DialogResult property to be set to DialogResult.Cancel. È possibile eseguire l'override del valore assegnato alla DialogResult proprietà quando l'utente fa clic sul pulsante Chiudi impostando la DialogResult Proprietà in un gestore eventi per l' FormClosing evento del modulo.You can override the value assigned to the DialogResult property when the user clicks the Close button by setting the DialogResult property in an event handler for the FormClosing event of the form.

Nota

Quando il Close metodo viene chiamato su un oggetto Form visualizzato come una finestra non modale, non è possibile chiamare il Show metodo per rendere visibile il form, perché le risorse del modulo sono già state rilasciate.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. Per nascondere un form e renderlo visibile, utilizzare il Hide metodo.To hide a form and then make it visible, use the Hide method.

Se il form è un form padre di interfaccia a documenti multipli (MDI), gli FormClosing eventi di tutti i form figlio MDI vengono generati prima che venga generato l'evento del form padre MDI FormClosing .If the form is a multiple-document interface (MDI) parent form, the FormClosing events of all MDI child forms are raised before the MDI parent form's FormClosing event is raised. Analogamente, FormClosed vengono generati gli eventi di tutti i form figlio MDI prima che FormClosed venga generato l'evento del form padre MDI.Likewise, the FormClosed events of all MDI child forms are raised before the FormClosed event of the MDI parent form is raised. L'annullamento dell' FormClosing evento di un form figlio MDI non impedisce la FormClosing generazione dell'evento del form padre MDI.Canceling the FormClosing event of an MDI child form does not prevent the FormClosing event of the MDI parent form from being raised. Tuttavia, l'annullamento dell'evento verrà impostato true sulla Cancel proprietà della FormClosingEventArgs classe passata come parametro al form padre.However, canceling the event will set to true the Cancel property of the FormClosingEventArgs class that is passed as a parameter to the parent form. Per forzare la chiusura di tutti i form padre e figlio MDI, impostare la Cancel proprietà su false nel form padre MDI.To force all MDI parent and child forms to close, set the Cancel property to false in the MDI parent form.

Per ulteriori informazioni sulla gestione degli eventi, consultare gestione e generazione di eventi.For more information about handling events, see Handling and Raising Events.

Si applica a

Vedi anche