Application 類別

定義

命名空間:

Windows.UI.Xaml

封裝應用程式及其可用的服務。

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

類別 App 會藉由在其建構函式中呼叫產生的 InitializeComponent 方法，將本身與對應的 XAML 產生關聯。 您可以將其他初始化程式碼新增至 App 建構函式，但通常只會新增程式碼，以將處理常式與應用程式事件產生關聯。 針對其他初始化程式碼，您應該覆寫一或多個初始化方法，例如 OnLaunched。

系統會在使用者切換至另一個應用程式或桌面時暫停您的應用程式，並在使用者切換回應用程式時繼續您的應用程式，以處理應用程式存留期。 不過，系統也可以在應用程式暫停時終止，以釋出資源。 您應該處理 Suspending 事件，以在終止時儲存應用程式狀態，並覆寫 OnLaunched 方法來還原應用程式狀態。 只有在應用程式暫停時可能需要重新整理可能已變更的任何顯示內容時，才應該處理 繼續 事件。 當應用程式繼續時，您不需要還原其他應用程式狀態。

由於其在應用程式模型、codegen 和啟用順序中的位置，因此 Application 對其 XAML 使用方式有一些限制：

• 除了 xmlns 宣告和 x：Class以外，根標籤上 Application 不能顯示任何其他屬性。
• 請勿嘗試變更來自專案範本 App.xaml 頁面的 x：Class 值，建置動作中存在使用該命名配置的其他相依性。
• 請勿在 XAML 中連接應用程式事件處理常式。 所有事件連接都應該在程式碼中完成 (通常是在建構函式中) 。 此外，您通常會使用方法覆寫，而不是事件 (的事件語法，例如覆寫 OnActivated 以回應應用程式生命週期的該階段。)
• XAML 中應用程式實例上唯一預期的屬性是使用 XAML 屬性元素使用方式填入 Application.Resources 屬性的一組元素。 如需詳細資訊，請參閱 資源。 若要為應用程式程式碼未攔截的任何例外狀況提供一般錯誤處理，請處理 UnhandledException 事件。

注意

應用程式主要檔案必須命名為 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)	載入位於指定相對位置的 XAML 檔案，並將它轉換成 XAML 檔案根項目所指定的 物件實例。
LoadComponent(Object, Uri, ComponentResourceLocation)	載入位於指定相對位置的 XAML 檔案，並將它轉換成 XAML 檔案根項目所指定的 物件實例。
OnActivated(IActivatedEventArgs)	當應用程式由一般啟動以外的一些方式啟動時叫用。
OnBackgroundActivated(BackgroundActivatedEventArgs)	在背景中啟動應用程式時叫用。
OnCachedFileUpdaterActivated(CachedFileUpdaterActivatedEventArgs)	由於 ActivationKind 作為 CachedFileUpdater的啟用合約而啟動應用程式時叫用。
OnFileActivated(FileActivatedEventArgs)	透過檔案開啟啟動應用程式時叫用。
OnFileOpenPickerActivated(FileOpenPickerActivatedEventArgs)	透過檔案開啟對話方塊關聯啟動應用程式時叫用。
OnFileSavePickerActivated(FileSavePickerActivatedEventArgs)	透過檔案儲存對話方塊關聯啟動應用程式時叫用。
OnLaunched(LaunchActivatedEventArgs)	啟動應用程式時叫用。 覆寫此方法以執行應用程式初始化，並在相關聯的 視窗中顯示初始內容。
OnSearchActivated(SearchActivatedEventArgs)	透過搜尋關聯啟動應用程式時叫用。
OnShareTargetActivated(ShareTargetActivatedEventArgs)	透過共用關聯啟動應用程式時叫用。
OnWindowCreated(WindowCreatedEventArgs)	當應用程式建立視窗時叫用。
Start(ApplicationInitializationCallback)	提供應用程式的進入點和要求初始化。 使用回呼具現化 Application 類別。

事件

EnteredBackground	當應用程式從前景移至背景時發生。
LeavingBackground	當應用程式從背景移至前景時發生。
Resuming	當應用程式從 [暫停] 狀態轉換為 [執行中] 狀態時發生。
Suspending	當應用程式從一些其他狀態轉換為暫停狀態時發生。
UnhandledException	發生于應用程式程式碼可以處理例外狀況時，如從原生層級Windows 執行階段錯誤轉送。 應用程式可以將發生次數標示為事件資料中已處理。

另請參閱

• Window
• 處理應用程式啟用
• 處理應用程式暫停
• 處理應用程式繼續執行