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 code 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.ShowConsole.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にイベント ハンドラーに渡されるtrueTo cancel the closure of a form, set the Cancel property of the FormClosingEventArgs 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のイベント ハンドラーのプロパティ、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 親フォームの前にすべての 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. 同様に、 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. ただしに設定は、イベントをキャンセルするtrueCancelのプロパティ、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.

適用対象

こちらもご覧ください