Form.FormClosing Form.FormClosing Form.FormClosing Form.FormClosing Event

Определение

Происходит перед закрытием формы.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. Чтобы сообщить о нескольких событиях или о событиях, которые происходят часто, рассмотрите Console.WriteLine возможность замены MessageBox.Show или добавления сообщения в многострочный 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 с именем. Form1To 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.CancelWhen 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.

Примечание

При вызове Formметодадля , отображаемого в виде немодального окна Show , нельзя вызвать метод, чтобы сделать форму видимой, поскольку ресурсы формы уже были освобождены. 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. Чтобы скрыть форму и сделать ее видимой, используйте 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. Отмена события дочерней формы MDI не FormClosing мешает порождению события родительской MDI-формы. FormClosingCanceling 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.

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

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