Form.FormClosing Событие

Определение

Происходит перед закрытием формы.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 

Примеры

В следующем примере демонстрируется использование этого элемента.The following example demonstrates the use of this member. В этом примере обработчик событий сообщает о возникновении события FormClosing.In the example, an event handler reports on the occurrence of the FormClosing event. Этот отчет поможет вам узнать, когда происходит событие и может помочь при отладке.This report helps you to learn when the event occurs and can assist you in debugging. Чтобы сообщить о нескольких событиях или о событиях, которые происходят часто, рассмотрите возможность замены MessageBox.Show на Console.WriteLine или Добавление сообщения в многострочный 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.

Чтобы выполнить пример кода, вставьте его в проект, содержащий экземпляр типа Form с именем Form1.To run the example code, paste it into a project that contains an instance of type Form named Form1. Затем убедитесь, что обработчик событий связан с событием FormClosing.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

Комментарии

Событие FormClosing возникает при закрытии формы.The FormClosing event occurs as the form is being closed. Когда форма закрывается, она удаляется, освобождая все ресурсы, связанные с формой.When a form is closed, it is disposed, releasing all resources associated with the form. Если отменить это событие, форма останется открытой.If you cancel this event, the form remains opened. Чтобы отменить закрытие формы, установите свойство Cancel FormClosingEventArgs, передаваемое обработчику событий, в значение true.To cancel the closure of a form, set the Cancel property of the FormClosingEventArgs passed to your event handler to true.

Когда форма отображается как модальное диалоговое окно, нажатие кнопки Закрыть (кнопка с крестиком в правом верхнем углу формы) приводит к скрытию формы, а свойство DialogResult устанавливается в 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. Можно переопределить значение, присваиваемое свойству DialogResult, когда пользователь нажмет кнопку " Закрыть ", задав свойство DialogResult в обработчике событий для события FormClosing формы.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.

Примечание

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

Если форма является родительской формой многодокументного интерфейса (MDI), то события FormClosing всех дочерних форм MDI вызываются до возникновения события FormClosing родительской формы MDI.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. Аналогичным образом события FormClosed всех дочерних форм MDI вызываются до того, как будет вызвано событие FormClosed родительской формы MDI.Likewise, the FormClosed events of all MDI child forms are raised before the FormClosed event of the MDI parent form is raised. Отмена события FormClosing дочерней формы MDI не мешает порождению события FormClosing родительской MDI-формы.Canceling the FormClosing event of an MDI child form does not prevent the FormClosing event of the MDI parent form from being raised. Однако при отмене события будет установлено значение true свойства Cancel класса FormClosingEventArgs, который передается в качестве параметра родительской форме.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. Чтобы принудительно закрыть все родительские и дочерние формы MDI, задайте для свойства Cancel значение false в родительской форме MDI.To force all MDI parent and child forms to close, set the Cancel property to false in the MDI parent form.

Дополнительные сведения об обработке событий см. в разделе обработка и вызов событий.For more information about handling events, see Handling and Raising Events.

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

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