Application クラス

リファレンス

定義

名前空間:: Microsoft.UI.Xaml

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

現在のアプリケーションとその利用可能なサービスを表します。

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 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(Microsoft.UI.Xaml.WinUIContract), 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

属性: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

注釈

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

アプリのエントリポイント
アプリスコープのリソース
未処理の例外検出

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

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

ヒント

詳細については、「アプリのライフサイクルWindows アプリ SDK」を参照してください。

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

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

注意

メインファイルには Application という名前を付App.xamlける必要があります。

コンストラクター

Application()

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

プロパティ

Current	現在のアプリケーションの Application オブジェクトを取得します。
DebugSettings	デバッグ環境での実行時のアプリの動作を宣言するオブジェクトを取得します。
DispatcherShutdownMode	スレッド上のすべての XAML ウィンドウが閉じられたときに DispatcherQueue イベントループを終了するかどうかを指定する値を取得または設定します。
FocusVisualKind	アプリがフォーカスを持つ UI 要素を示すために使用できるビジュアルフィードバックの種類を取得または設定します。
HighContrastAdjustment	ハイコントラストテーマが有効になっている場合に、フレームワークがビジュアルプロパティを自動的に調整するかどうかを示す値を取得または設定します。
RequestedTheme	アプリのテーマ全体の明るい暗い設定を決定する値を取得または設定します。
Resources	スタイル、テンプレート、ブラシなど、アプリケーションスコープのリソースのコレクションを取得します。

メソッド

Exit()	アプリをシャットダウンします。
LoadComponent(Object, Uri)	指定した相対位置にある XAML ファイルを読み込み、XAML ファイルのルート要素で指定されたオブジェクトのインスタンスに変換します。
LoadComponent(Object, Uri, ComponentResourceLocation)	指定した相対位置にある XAML ファイルを読み込み、XAML ファイルのルート要素で指定されたオブジェクトのインスタンスに変換します。
OnLaunched(LaunchActivatedEventArgs)	アプリケーションの起動時に呼び出されます。アプリケーションの初期化を実行し、新しいウィンドウを作成するには、このメソッドをオーバーライドします。
Start(ApplicationInitializationCallback)	エントリポイントを提供し、アプリケーションの初期化を要求します。指定した ApplicationInitializationCallback を使用して、Application クラスをインスタンス化します。

イベント

ResourceManagerRequested	リソース URI を解決するためにフレームワークによって使用されるカスタム `IResourceManager` 実装を提供するために、新しい WinUI スレッドの起動時に発生します。
UnhandledException	ネイティブレベルのWindows ランタイムエラーから転送された例外をアプリコードで処理できる場合に発生します。アプリは、イベントデータで処理済みとしてオカレンスをマークできます。

適用対象