Application.ShutdownMode プロパティ

定義

Shutdown() メソッドが呼び出される条件を取得または設定します。Gets or sets the condition that causes the Shutdown() method to be called.

public:
 property System::Windows::ShutdownMode ShutdownMode { System::Windows::ShutdownMode get(); void set(System::Windows::ShutdownMode value); };
public System.Windows.ShutdownMode ShutdownMode { get; set; }
member this.ShutdownMode : System.Windows.ShutdownMode with get, set
Public Property ShutdownMode As ShutdownMode

プロパティ値

ShutdownMode の列挙値です。A ShutdownMode enumeration value. 既定値は OnLastWindowCloseです。The default value is OnLastWindowClose.

次の例は、アプリケーションを明示的に閉じる必要があることを指定するように ShutdownMode を構成する方法を示しています。The following example shows how to configure ShutdownMode to specify that an application must be closed explicitly.

<Application
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    StartupUri="MainWindow.xaml"
    ShutdownMode="OnExplicitShutdown"
    >
</Application>

注釈

アプリケーションの Shutdown メソッドが呼び出された場合にのみ、アプリケーションの実行が停止します。Applications stop running only when the Shutdown method of the Application is called. シャットダウンは、ShutdownMode プロパティの値によって指定されたように、暗黙的または明示的に発生する場合があります。Shut down can occur implicitly or explicitly, as specified by the value of the ShutdownMode property.

ShutdownModeOnLastWindowCloseに設定した場合、Windows Presentation Foundation (WPF) は、現在インスタンス化されているウィンドウがメインウィンドウとして設定されている場合でも、アプリケーションの最後のウィンドウを閉じると暗黙的に Shutdown を呼び出します (「MainWindow」を参照)。If you set ShutdownMode to OnLastWindowClose, Windows Presentation Foundation (WPF) implicitly calls Shutdown when the last window in an application closes, even if any currently instantiated windows are set as the main window (see MainWindow).

OnMainWindowCloseShutdownMode により、他のウィンドウが現在開いている場合でも、WPF は MainWindow が閉じるときに Shutdown を暗黙的に呼び出します。A ShutdownMode of OnMainWindowClose causes WPF to implicitly call Shutdown when the MainWindow closes, even if other windows are currently open.

一部のアプリケーションの有効期間は、メインウィンドウまたは最後のウィンドウが閉じられたとき、または windows に依存していない場合に依存しないことがあります。The lifetime of some applications may not be dependent on when the main window or last window is closed, or may not be dependent on windows at all. これらのシナリオでは、ShutdownMode プロパティを OnExplicitShutdownに設定する必要があります。そのためには、アプリケーションを停止するための明示的な Shutdown メソッド呼び出しが必要です。For these scenarios you need to set the ShutdownMode property to OnExplicitShutdown, which requires an explicit Shutdown method call to stop the application. それ以外の場合、アプリケーションはバックグラウンドで実行を継続します。Otherwise, the application continues running in the background.

ShutdownMode は、XAMLXAML またはプログラムによってコードから宣言して構成できます。ShutdownMode can be configured declaratively from XAMLXAML or programmatically from code.

このプロパティは、Application オブジェクトを作成したスレッドからのみ使用できます。This property is available only from the thread that created the Application object.

適用対象

こちらもご覧ください