Application 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示当前应用程序及其可用服务。
/// [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 ApplicationPublic Class Application<Application />
- 继承
- 属性
注解
类 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, ComponentResourceLocation) |
加载位于指定相对位置的 XAML 文件，并将其转换为由 XAML 文件的根元素指定的 对象的实例。 |
| LoadComponent(Object, Uri) |
加载位于指定相对位置的 XAML 文件，并将其转换为由 XAML 文件的根元素指定的 对象的实例。 |
| OnLaunched(LaunchActivatedEventArgs) |
启动应用程序时调用。 重写此方法以执行应用程序初始化并创建新窗口。 |
| Start(ApplicationInitializationCallback) |
提供应用程序的入口点和请求初始化。 使用指定的 ApplicationInitializationCallback 实例化 Application 类。 |
事件
| ResourceManagerRequested |
在启动新的 WinUI 线程期间发生，以便提供框架用于解析资源 URI 的自定义 |
| UnhandledException |
当异常可由应用代码处理时发生，因为从本机级别Windows 运行时错误转发。 应用可以将事件标记为在事件数据中已处理。 |