Application クラス

定義

アプリとその使用可能なサービスをカプセル化します。

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Application
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Application
Public Class Application
<Application />
 
継承
Object IInspectable Application
属性

Windows の要件

デバイス ファミリ
Windows 10 (10.0.10240.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v1.0 で導入)

注釈

Application クラスはアプリをカプセル化し、次のサービスを提供します。

  • アプリのエントリ ポイント(特にさまざまなアクティブ化コントラクト用)
  • アプリの有効期間管理
  • アプリ スコープのリソース
  • 未処理の例外検出

Application オブジェクトは通常、App.xaml 用の最初の XAML で提供されます。 Visual Studio の既定のプロジェクト テンプレートは、Application から派生したクラスを App 生成し、初期化コードを追加できるエントリ ポイントを提供します。

クラスは App 、コンストラクターで生成された InitializeComponent メソッドを呼び出すことによって、対応する XAML に自身を関連付けます。 コンストラクターに初期化コードを App 追加できますが、通常は、ハンドラーを Application イベントに関連付けるコードのみを追加します。 その他の初期化コードの場合は、 OnLaunched などの 1 つ以上の初期化メソッドをオーバーライドする必要があります。

システムは、ユーザーが別のアプリまたはデスクトップに切り替えるたびにアプリを中断し、ユーザーが切り替えるたびにアプリを再開することで、アプリの有効期間を処理します。 ただし、リソースを解放するために、中断中にアプリを終了することもできます。 終了した場合にアプリの状態を保存するには Suspending イベントを 処理し、 OnLaunched メソッドをオーバーライドしてアプリの状態を復元する必要があります。 再開イベントは、アプリが中断されている間に変更された可能性のある表示コンテンツを更新する必要がある場合にのみ処理する必要があります。 アプリの再開時に他のアプリの状態を復元する必要はありません。

アプリケーション モデル、codegen、およびアクティブ化シーケンスでの位置により、アプリケーションには XAML の使用に関するいくつかの制限があります。

  • xmlns 宣言と x:Class 以外に、ルート タグに他の属性を Application 表示することはできません。
  • プロジェクト テンプレート App.xaml ページから 取得した x:Class 値を変更しないでください。ビルド アクションに存在する名前付けスキームの使用には、追加の依存関係があります。
  • XAML でアプリケーション イベント ハンドラーを接続しないでください。 すべてのイベント配線は、コード (通常はコンストラクター) で行う必要があります。 また、通常は、イベントのイベント構文ではなくメソッドオーバーライドを使用します (たとえば、 OnActivated をオーバーライドして、アプリケーションライフ サイクルのそのフェーズに応答します)。
  • XAML の Application インスタンスに必要なプロパティは、XAML プロパティ要素の使用法を使用して Application.Resources プロパティを設定する要素のセットのみです。 詳細については、「 リソース」を参照してください。 アプリ コードでキャッチされない例外に対して一般的なエラー処理を提供するには、 UnhandledException イベントを処理します。

Note

アプリケーション メイン ファイルには という名前を付App.xamlける必要があります。

バージョン履歴

Windows のバージョン SDK バージョン 追加された値
1607 14393 EnteredBackground
1607 14393 FocusVisualKind
1607 14393 LeavingBackground
1607 14393 OnBackgroundActivated
1607 14393 RequiresPointerMode
1703 15063 HighContrastAdjustment

コンストラクター

Application()

Application クラスの新しいインスタンスを初期化します。

プロパティ

Current

現在の アプリケーションの Application オブジェクトを取得します。

DebugSettings

デバッグ環境での実行時のアプリの動作を宣言する オブジェクトを取得します。

FocusVisualKind

アプリがフォーカスのある UI 要素を示すために使用できる視覚的フィードバックの種類を取得または設定します。

このプロパティは、キーボードやゲーム パッドなどの主要なイベントを生成できる入力デバイスに対してのみ有効です。

HighContrastAdjustment

ハイ コントラスト テーマが有効になっている場合に、フレームワークがビジュアル プロパティを自動的に調整するかどうかを示す値を取得または設定します。

RequestedTheme

アプリのテーマ全体の明るい暗い設定を決定する値を取得または設定します。

RequiresPointerMode

UWP アプリがマウス モードをサポートするかどうかを取得または設定します。これは、ゲーム パッドやリモート コントロールなどのポインター以外の入力デバイスでポインター操作エクスペリエンスをエミュレートします。 (入れ子になった要素はすべて、この動作を継承します)。

Resources

スタイル、テンプレート、ブラシなど、アプリケーション スコープのリソースのコレクションを取得します。

メソッド

Exit()

アプリをシャットダウンします。

LoadComponent(Object, Uri, ComponentResourceLocation)

指定した相対位置にある XAML ファイルを読み込み、XAML ファイルのルート要素で指定された オブジェクトのインスタンスに変換します。

LoadComponent(Object, Uri)

指定した相対位置にある XAML ファイルを読み込み、XAML ファイルのルート要素で指定された オブジェクトのインスタンスに変換します。

OnActivated(IActivatedEventArgs)

通常の起動以外の何らかの方法でアプリケーションがアクティブ化されたときに呼び出されます。

OnBackgroundActivated(BackgroundActivatedEventArgs)

アプリケーションがバックグラウンドでアクティブ化されたときに呼び出されます。

OnCachedFileUpdaterActivated(CachedFileUpdaterActivatedEventArgs)

ActivationKind を CachedFileUpdater として使用したアクティブ化コントラクトが原因でアプリケーションがアクティブ化されたときに呼び出されます。

OnFileActivated(FileActivatedEventArgs)

ファイルを開いてアプリケーションをアクティブ化するときに呼び出されます。

OnFileOpenPickerActivated(FileOpenPickerActivatedEventArgs)

ファイルを開くダイアログの関連付けを使用してアプリケーションをアクティブ化するときに呼び出されます。

OnFileSavePickerActivated(FileSavePickerActivatedEventArgs)

ファイル保存ダイアログの関連付けを使用してアプリケーションをアクティブ化するときに呼び出されます。

OnLaunched(LaunchActivatedEventArgs)

アプリケーションの起動時に呼び出されます。 アプリケーションの初期化を実行し、関連付けられている Window に初期コンテンツを表示するには、このメソッドをオーバーライド します

OnSearchActivated(SearchActivatedEventArgs)

検索の関連付けを通じてアプリケーションがアクティブ化されたときに呼び出されます。

OnShareTargetActivated(ShareTargetActivatedEventArgs)

アプリケーションが共有の関連付けを通じてアクティブ化されるときに呼び出されます。

OnWindowCreated(WindowCreatedEventArgs)

アプリケーションがウィンドウを作成するときに呼び出されます。

Start(ApplicationInitializationCallback)

エントリ ポイントを提供し、アプリケーションの初期化を要求します。 コールバックを使用して Application クラスをインスタンス化します。

イベント

EnteredBackground

アプリがフォアグラウンドからバックグラウンドに移動したときに発生します。

LeavingBackground

アプリがバックグラウンドからフォアグラウンドに移動したときに発生します。

Resuming

アプリケーションが中断状態から実行中状態に移行したときに発生します。

Suspending

アプリケーションが他の状態から中断状態に移行したときに発生します。

UnhandledException

ネイティブ レベルのWindows ランタイム エラーから転送された例外をアプリ コードで処理できる場合に発生します。 アプリは、イベント データで処理済みとして発生をマークできます。

適用対象

こちらもご覧ください