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 code 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 'Form1_Closing
End Class 'Form1

注釈

注意事項

Closingイベントは、.NET Framework version 2.0 では古いは使用して、FormClosingイベント代わりにします。The Closing event is obsolete in the .NET Framework version 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にイベント ハンドラーに渡されるtrueTo cancel the closure of a form, set the Cancel property of the CancelEventArgs passed to your event handler to true.

モーダル ダイアログ ボックスとしてフォームが表示されたら、クリックすると、閉じるボタン (フォームの右上隅にある x ボタン) と非表示にするためのフォームと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.ClosedForm.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 親フォームの前にすべての MDI 子フォームのイベントが発生Closingイベントが発生します。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. ただしに設定は、イベントをキャンセルするtrueCancelのプロパティ、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.

適用対象

こちらもご覧ください