Form.Closing Form.Closing Form.Closing Form.Closing Event

Определение

Происходит при закрытии формы.Occurs when the form is closing.

public:
 event System::ComponentModel::CancelEventHandler ^ Closing;
[System.ComponentModel.Browsable(false)]
public event System.ComponentModel.CancelEventHandler Closing;
member this.Closing : System.ComponentModel.CancelEventHandler 
Public Custom Event Closing As CancelEventHandler 
Атрибуты

Примеры

В следующем примере Closing используется для проверки, изменился ли текст в TextBox.The following example uses Closing to test if the text in a TextBox has changed. Если это так, пользователю будет предложено сохранить изменения в файл.If it has, the user is asked whether to save the changes to a file.

private:
   void Form1_Closing( Object^ /*sender*/, System::ComponentModel::CancelEventArgs^ e )
   {
      // Determine if text has changed in the textbox by comparing to original text.
      if ( textBox1->Text != strMyOriginalText )
      {
         // Display a MsgBox asking the user to save changes or abort.
         if ( MessageBox::Show( "Do you want to save changes to your text?", "My Application", MessageBoxButtons::YesNo ) == ::DialogResult::Yes )
         {
            // Cancel the Closing event from closing the form.
            e->Cancel = true;

            // Call method to save file...
         }
      }
   }
private void Form1_Closing(object sender, System.ComponentModel.CancelEventArgs e)
{
   // Determine if text has changed in the textbox by comparing to original text.
   if (textBox1.Text != strMyOriginalText)
   {
      // Display a MsgBox asking the user to save changes or abort.
      if(MessageBox.Show("Do you want to save changes to your text?", "My Application",
         MessageBoxButtons.YesNo) ==  DialogResult.Yes)
      {
         // Cancel the Closing event from closing the form.
         e.Cancel = true;
         // Call method to save file...
      }
   }
}
   Private Sub Form1_Closing(sender As Object, e As System.ComponentModel.CancelEventArgs) Handles MyBase.Closing
      ' Determine if text has changed in the textbox by comparing to original text.
      If textBox1.Text <> strMyOriginalText Then
         ' Display a MsgBox asking the user to save changes or abort.
         If MessageBox.Show("Do you want to save changes to your text?", "My Application", MessageBoxButtons.YesNo) = DialogResult.Yes Then
            ' Cancel the Closing event from closing the form.
            e.Cancel = True
         End If ' Call method to save file...
      End If
   End Sub
End Class

Комментарии

Внимание!

Событие Closing является устаревшим, начиная с .NET Framework 2,0; Вместо этого используйте событие FormClosing.The Closing event is obsolete starting with the .NET Framework 2.0; use the FormClosing event instead.

Событие Closing возникает при закрытии формы.The Closing event occurs as the form is being closed. Когда форма закрывается, освобождаются все ресурсы, созданные в объекте, и форма удаляется.When a form is closed, all resources created within the object are released and the form is disposed. Если отменить это событие, форма останется открытой.If you cancel this event, the form remains opened. Чтобы отменить закрытие формы, установите свойство Cancel CancelEventArgs, передаваемое обработчику событий, в значение true.To cancel the closure of a form, set the Cancel property of the CancelEventArgs 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 в обработчике событий для события Closing формы.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 Closing 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. Чтобы скрыть форму и сделать ее видимой, используйте метод Control.Hide.To hide a form and then make it visible, use the Control.Hide method.

Внимание!

События Form.Closed и Form.Closing не вызываются при вызове метода Application.Exit для выхода из приложения.The Form.Closed and Form.Closing events are not raised when the Application.Exit method is called to exit your application. При наличии кода проверки в любом из этих событий, которые необходимо выполнить, следует вызывать метод Form.Close для каждой открытой формы по отдельности перед вызовом метода Exit.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.

Если форма является родительской MDI-формой, события Closing всех дочерних форм MDI вызываются до возникновения события Closing родительской формы MDI.If the form is an MDI parent form, the Closing events of all MDI child forms are raised before the MDI parent form's Closing event is raised. Кроме того, события Closed всех дочерних форм MDI вызываются до того, как будет вызвано событие Closed родительской формы MDI.In addition, the Closed events of all MDI child forms are raised before the Closed event of the MDI parent form is raised. Отмена события Closing дочерней формы MDI не мешает порождению события Closing родительской MDI-формы.Canceling the Closing event of an MDI child form does not prevent the Closing event of the MDI parent form from being raised. Однако при отмене события будет установлено значение true свойства Cancel CancelEventArgs, которое передается в качестве параметра родительской форме.However, canceling the event will set to true the Cancel property of the CancelEventArgs 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.

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

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