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 事件。

注意

main 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应用生命周期