Application 類別

定義

命名空間:

Microsoft.UI.Xaml

表示目前的應用程式及其可用的服務。

/// [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 中的預設專案範本會產生 App 衍生自 Application 的類別，並提供您可以在其中新增初始化程式代碼的進入點。

類別 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	在啟動新的 WinUI 線程期間發生，讓您提供架構用來解析資源 URI 的自定義 IResourceManager 實作。
UnhandledException	發生於應用程式程式代碼可以處理例外狀況時，如從原生層級 Windows 執行階段 錯誤轉送。 應用程式可以將發生次數標示為事件數據中已處理。

另請參閱

• Window
• Windows 應用程式 SDK 應用程式生命週期