次の方法で共有


Application クラス

定義

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

/// [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
属性

注釈

クラスは 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, ComponentResourceLocation)

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

LoadComponent(Object, Uri)

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

OnLaunched(LaunchActivatedEventArgs)

アプリケーションの起動時に呼び出されます。 アプリケーションの初期化を実行し、新しいウィンドウを作成するには、このメソッドをオーバーライドします。

Start(ApplicationInitializationCallback)

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

イベント

ResourceManagerRequested

リソース URI を解決するためにフレームワークによって使用されるカスタム IResourceManager 実装を提供するために、新しい WinUI スレッドの起動時に発生します。

UnhandledException

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

適用対象

こちらもご覧ください