Application クラス

リファレンス

定義

名前空間:: Windows.UI.Xaml

重要

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

編集

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

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

属性: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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 ランタイムエラーから転送された例外をアプリコードで処理できる場合に発生します。アプリは、イベントデータで処理済みとして発生をマークできます。

適用対象

次の方法で共有