Application 类

定义

封装应用及其可用服务。

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

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

每当用户切换到另一个应用或桌面时,系统就会暂停应用生存期,并在用户切换回应用时恢复应用。 但是,系统还可以在应用暂停时终止应用,以便释放资源。 应处理 挂起 事件,以在终止时保存应用状态,并重写 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 元素的视觉反馈的类型。

此属性仅适用于可以生成键事件的输入设备,例如键盘或 Xbox 控制器。

HighContrastAdjustment

获取或设置一个值,该值指示在启用高对比度主题时框架是否自动调整视觉属性。

RequestedTheme

获取或设置一个值,该值确定应用的整体主题的浅色首选项。

RequiresPointerMode

获取或设置 UWP 应用是否支持鼠标模式,该模式模拟具有非指针输入设备(如 Xbox 游戏板或远程控制)的指针交互体验。 (所有嵌套元素继承此行为。)

Resources

获取应用程序范围的资源的集合,例如样式、模板和画笔。

方法

Exit()

关闭应用。

LoadComponent(Object, Uri)

加载位于指定相对位置的 XAML 文件,并将其转换为由 XAML 文件的根元素指定的对象的实例。

LoadComponent(Object, Uri, ComponentResourceLocation)

加载位于指定相对位置的 XAML 文件,并将其转换为由 XAML 文件的根元素指定的对象的实例。

OnActivated(IActivatedEventArgs)

当应用程序被除正常启动以外的某种方式激活时调用。

OnBackgroundActivated(BackgroundActivatedEventArgs)

在后台激活应用程序时调用。

OnCachedFileUpdaterActivated(CachedFileUpdaterActivatedEventArgs)

由于 ActivationKindCachedFileUpdater 的激活协定而激活应用程序时调用。

OnFileActivated(FileActivatedEventArgs)

通过文件打开激活应用程序时调用。

OnFileOpenPickerActivated(FileOpenPickerActivatedEventArgs)

通过文件打开的对话关联激活应用程序时调用。

OnFileSavePickerActivated(FileSavePickerActivatedEventArgs)

通过文件保存对话关联激活应用程序时调用。

OnLaunched(LaunchActivatedEventArgs)

启动应用程序时调用。 重写此方法以执行应用程序初始化并在关联的 窗口中显示初始内容。

OnSearchActivated(SearchActivatedEventArgs)

通过搜索关联激活应用程序时调用。

OnShareTargetActivated(ShareTargetActivatedEventArgs)

通过共享关联激活应用程序时调用。

OnWindowCreated(WindowCreatedEventArgs)

应用程序创建窗口时调用。

Start(ApplicationInitializationCallback)

提供应用程序的入口点和请求初始化。 使用回调实例化 Application 类。

活动

EnteredBackground

当应用从前台移动到背景时发生。

LeavingBackground

当应用从后台移动到前台时发生。

Resuming

当应用程序从挂起状态转换为“正在运行”状态时发生。

Suspending

当应用程序从某些其他状态转换为挂起状态时发生。

UnhandledException

当应用代码可以处理异常时发生,如从本机级别Windows 运行时错误转发。 应用可以将匹配项标记为在事件数据中处理。

适用于

另请参阅