Windows.ApplicationModel.Background 命名空间

使应用能够计划后台任务以在应用挂起时运行应用代码。

后台任务适用于不需要用户交互或处理 Toast 操作的小型工作项。 适合后台任务的方案包括下载邮件、显示传入聊天邮件的 Toast 通知，或对系统条件中的更改做出反应。

有关实现 后台任务的指导，请参阅使用 JavaScript 和 HTML) ( 后台任务支持应用或使用后台任务支持应用 。 有关演示如何实现后台任务的示例代码，请参阅 后台任务示例。

类

ActivitySensorTrigger	表示 在 ActivitySensor 收到输入时激活的触发器。 当应用程序需要响应活动传感器时，会使用此方法。
AlarmApplicationManager	请求用户设置警报的权限，并检索应用设置警报的用户权限状态。
AppBroadcastTrigger	表示在应用程序开始游戏广播时触发后台任务运行的事件。
AppBroadcastTriggerProviderInfo	提供有关正在广播游戏的应用程序的信息，例如其徽标、显示名称和视频特征。
ApplicationTrigger	这样，就可以从应用程序中以编程方式触发后台任务。
ApplicationTriggerDetails	ApplicationTrigger 的详细信息。
AppointmentStoreNotificationTrigger	表示启动后台任务以处理约会存储更改的触发器。
BackgroundExecutionManager	管理运行后台任务的权限。
BackgroundTaskBuilder	表示要向系统注册的后台任务。
BackgroundTaskCompletedEventArgs	表示发送完成通知时任务的完成信息。
BackgroundTaskDeferral	表示 IBackgroundTaskInstance.GetDeferral 方法返回的后台任务延迟。
BackgroundTaskProgressEventArgs	表示发送进度更新通知时任务的进度信息。
BackgroundTaskRegistration	表示已注册到系统的后台任务。
BackgroundTaskRegistrationGroup	提供分组语义，以便可以单独维护后台任务注册。
BackgroundWorkCost	检索有关后台任务的资源可用性的提示。 后台任务可以使用此提示来确定激活时要完成的工作量。
BluetoothLEAdvertisementPublisherTrigger	表示注册为在后台播发蓝牙 LE 播发的触发器。
BluetoothLEAdvertisementWatcherTrigger	表示注册以在后台扫描蓝牙 LE 播发的触发器。
CachedFileUpdaterTrigger	表示启动后台任务以启用缓存文件更新程序协定的触发器。
CachedFileUpdaterTriggerDetails	提供有关调用触发器的缓存文件操作的详细信息。
ChatMessageNotificationTrigger	表示在有短信通知时激活的触发器。
ChatMessageReceivedNotificationTrigger	表示启动后台任务的触发器，该任务处理可能需要根据其内容筛选的任何传入消息。 有关筛选消息的详细信息，请参阅 Windows.ApplicationModel.CommunicationBlocking。
CommunicationBlockingAppSetAsActiveTrigger	表示一个触发器，用于在选择通信阻止应用程序作为首选阻止应用时激活该应用程序。 一个用户可以同时安装多个通信阻止应用程序。 此触发器用于让应用程序知道它已被选为活动通信阻止应用程序。 有关通信阻止 API 的详细信息，请参阅 Windows.ApplicationModel.CommunicationBlocking。
ContactStoreNotificationTrigger	表示启动后台任务以处理联系人存储更改的触发器。
ContentPrefetchTrigger	提供在预提取 Web 资源时运行自定义处理程序的功能。
ConversationalAgentTrigger	表示一个触发器，该触发器启动后台任务以通过 Windows 平台代理激活运行时 (AAR) 处理数字助手通信。
CustomSystemEventTrigger	此类允许指定自定义系统触发器，以便可以注册它，并在系统触发时做出响应。
DeviceConnectionChangeTrigger	表示在设备连接状态更改时启动后台任务的触发器。
DeviceManufacturerNotificationTrigger	表示启动后台任务以启用设备制造商操作的触发器。
DeviceServicingTrigger	表示应用程序可以触发以启动长时间运行的更新 (设备固件或设置) 的事件。 Windows 8.1使你能够为通过 USB、HID 和蓝牙进行通信的外围设备开发 UWP 应用。 例如，用户可能需要将电脑上的内容同步到设备或从设备同步，或者对设备本身执行长时间运行的更新，例如设置或固件更新。 Windows 8.1提供两个后台任务和相应的 API，允许设备在后台同步和更新：DeviceServicingTrigger 和 DeviceUseTrigger。 本主题提供 DeviceServicingTrigger 的 API 参考信息 - 有关在设备应用上下文中使用此触发器的信息，请参阅 UWP 设备应用的设备同步和更新。 DeviceServicingTrigger 后台任务允许与外围设备交互的 UWP 应用在应用暂停时执行长时间运行的设备更新，例如设置传输或固件更新。 每次使用后台任务时，在后台更新设备都需要用户批准。 与 DeviceUseTrigger 后台任务不同，DeviceServicingTrigger 后台任务允许设备重启和断开连接，并允许最多 30 分钟的后台活动。 有关 DeviceServicingTrigger 后台任务策略要求的更多详细信息，请参阅本页的 部分。 有关使用 DeviceServicingTrigger 的信息，请参阅 UWP 设备应用的设备同步和更新。 有关使用 DeviceUseTrigger 的信息，请参阅 从后台任务访问传感器和设备。 重要 此触发器不能与单进程后台任务一起使用。
DeviceUseTrigger	表示Windows 运行时应用可以触发以使用设备或传感器启动长时间运行的操作的事件。 DeviceUseTrigger 允许Windows 运行时应用访问后台的传感器和外围设备，即使前台应用已暂停也是如此。 例如，根据应用运行所在的位置，它可以使用后台任务将数据与设备或监视器传感器同步。 此类可用于 UWP 应用和 Windows Phone 8.x 应用。 但是， DeviceUseTrigger 后台任务支持不同的 API，并且受制于不同的策略，具体取决于它在电脑或手机) (运行的位置。 若要了解有关这些差异的详细信息，请参阅 从后台任务访问传感器和设备。 重要 此触发器不能与单进程后台任务一起使用。 有关演示如何在电脑上使用 DeviceUseTrigger 的示例，请参阅 自定义 USB 设备示例。 有关手机示例，请参阅 背景传感器示例。
DeviceWatcherTrigger	表示一个事件，该事件导致后台任务在设备列表发生更改时运行。 由 GetBackgroundTrigger 返回。
EmailStoreNotificationTrigger	表示启用电子邮件存储更改通知的触发器。
GattCharacteristicNotificationTrigger	表示一个触发器，该触发器在收到蓝牙 LE GATT 特征的传入更改通知时启动后台任务。
GattServiceProviderTrigger	构造可在后台保留 (GATT) 服务的泛型属性。
GattServiceProviderTriggerResult	此类包含由 GattServiceProviderTrigger.CreateAsync () 创建的触发器。
GeovisitTrigger	表示触发与 Visits 相关的后台任务的事件。
LocationTrigger	表示触发后台任务的位置事件。 这用于地理围栏。
MaintenanceTrigger	表示维护触发器。
MediaProcessingTrigger	表示启动后台任务以执行媒体处理的触发器。
MobileBroadbandDeviceServiceNotificationTrigger	表示在网络发送 SIM 工具命令时激活的触发器。 接收此通知的应用随后处理 SIM 工具命令。 此功能仅适用于移动运营商应用和 UWP 应用，前提是移动网络运营商具有特权访问权限。 有关详细信息，请参阅 移动宽带。
MobileBroadbandPcoDataChangeTrigger	表示触发后台任务运行的手机网络协议配置选项更改事件。
MobileBroadbandPinLockStateChangeTrigger	表示指示 SIM PIN 锁定状态何时更改的触发器。 此功能仅适用于移动运营商应用和 UWP 应用，前提是移动网络运营商具有特权访问权限。 有关详细信息，请参阅 移动宽带。
MobileBroadbandRadioStateChangeTrigger	表示指示移动宽带无线电状态何时更改的触发器。 例如，当移动设备转换到飞行模式或从飞行模式转换时，此触发器将激活。 此功能仅适用于移动运营商应用和 UWP 应用，前提是移动网络运营商具有特权访问权限。 有关详细信息，请参阅 移动宽带。
MobileBroadbandRegistrationStateChangeTrigger	表示指示移动宽带注册状态何时更改的触发器。 例如，当移动设备转换到漫游或从漫游转换时，此触发器将激活。 此功能仅适用于移动运营商应用和 UWP 应用，前提是移动网络运营商具有特权访问权限。 有关详细信息，请参阅 移动宽带。
NetworkOperatorDataUsageTrigger	表示当本地数据计数器估计移动宽带接口上发送和接收) 的字节使用量 (已更改可操作阈值时启动后台任务的触发器。 注意 此功能仅适用于由移动网络运营商授予特权访问权限的移动运营商应用和 UWP 应用。 如果要使用此 API 并将应用发布到 Microsoft Store，则需要获得特殊批准。 有关详细信息，请参阅应用功能声明主题中的受限功能部分和移动宽带。
NetworkOperatorHotspotAuthenticationTrigger	表示移动网络运营商热点身份验证触发器。 注意 在预配引用此应用来处理热点身份验证的 WLAN 配置文件后，应用只能实例化此对象并注册热点身份验证事件。 有关详细信息，请参阅 适用于无线热点运营商的 Windows 8 集成。
NetworkOperatorNotificationTrigger	表示移动网络运营商通知触发器。
PaymentAppCanMakePaymentTrigger	此类表示 PaymentAppCanMakePayment 触发器。
PhoneTrigger	表示触发后台任务的电话事件。
PushNotificationTrigger	表示一个 对象，该对象在应用上调用后台工作项以响应 原始通知的接收。
RcsEndUserMessageAvailableTrigger	表示在新的富通信服务 (RCS) 消息可用时启动后台任务的触发器。
RfcommConnectionTrigger	表示在建立 RFCOMM 入站或出站连接时启动后台任务的触发器。
SecondaryAuthenticationFactorAuthenticationTrigger	表示代表配套设备启动后台任务的触发器。
SensorDataThresholdTrigger	表示在超出传感器阈值限制时做出响应的触发器。
SmartCardTrigger	表示由智能卡触发的事件。
SmsMessageReceivedTrigger	表示短信到达时引发的触发器。
SocketActivityTrigger	表示启动后台任务以处理套接字活动的触发器。
StorageLibraryChangeTrackerTrigger	表示 StorageFolder 中触发要运行的后台任务的文件更改。
StorageLibraryContentChangedTrigger	创建在指定库中更改文件时将触发的触发器。
SystemCondition	表示后台任务运行必须有效的系统条件。
SystemTrigger	表示触发后台任务运行的系统事件。
TetheringEntitlementCheckTrigger	表示触发后台任务运行的共享事件。
TimeTrigger	表示触发要运行的后台任务的时间事件。
ToastNotificationActionTrigger	表示一个事件，该事件导致后台任务在用户对交互式 Toast 通知执行操作时运行。
ToastNotificationHistoryChangedTrigger	表示在清除应用的 Toast 通知历史记录、向应用通知历史记录添加或删除一个或多个 Toast 通知时，或者当应用的一个或多个 Toast 通知过期并从通知历史记录中删除时，导致后台任务运行的事件。
UserNotificationChangedTrigger	表示添加或删除 UserNotification 时触发的触发器。
WiFiOnDemandHotspotConnectTrigger	表示一个事件，该事件导致后台任务在用户希望连接到特定的按需热点网络时运行。 后台任务代码应将 IBackgroundTaskInstance.TriggerDetails 属性的值转换为 WiFiOnDemandHotspotConnectTriggerDetails。 注意 如果要在 UWP 应用中使用此 API 并将应用发布到 Microsoft Store，则需要请求特殊批准才能使用 自定义功能Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (按需网络功能) 。 有关详细信息，请参阅 自定义功能。 按需网络功能将仅提供给在支持网络连接的硬件设备和 Windows 电脑之间构建端到端 Wi-Fi 热点方案的应用开发人员。
WiFiOnDemandHotspotUpdateMetadataTrigger	表示当用户打开操作系统 (操作系统) Wi-Fi 网络列表时运行后台任务的事件，就像连接到新的 Wi-Fi 网络一样。 注意 如果要在 UWP 应用中使用此 API 并将应用发布到 Microsoft Store，则需要请求特殊批准才能使用 自定义功能Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (按需网络功能) 。 有关详细信息，请参阅 自定义功能。 按需网络功能将仅提供给在支持网络连接的硬件设备和 Windows 电脑之间构建端到端 Wi-Fi 热点方案的应用开发人员。

接口

IBackgroundCondition	用于强制实施系统条件对象类型。
IBackgroundTask	提供执行后台任务工作的方法。
IBackgroundTaskInstance	提供对后台任务实例的访问。
IBackgroundTaskInstance2	提供对后台任务实例的访问。 继承自 IBackgroundTaskInstance 接口并添加 GetThrottleCount 方法。
IBackgroundTaskInstance4	提供对后台任务实例的访问，包括有关用户的信息。
IBackgroundTaskRegistration	提供对已注册后台任务的访问权限。
IBackgroundTaskRegistration2	提供对已注册后台任务的访问权限。 继承自 IBackgroundTaskRegistration 接口并添加 Trigger 属性。
IBackgroundTaskRegistration3	表示已注册为一组相关后台任务的一部分的后台任务。
IBackgroundTrigger	表示触发器事件的基接口。

枚举

AlarmAccessStatus	指示用户是否授予应用设置警报的权限。
ApplicationTriggerResult	触发后台任务的请求的结果。 RequestAsync 方法返回此枚举类型的值。
BackgroundAccessRequestKind	指定应用可以请求的后台活动的级别。
BackgroundAccessStatus	此枚举指定应用执行后台活动的能力。 在注册后台任务之前，应用必须成功调用 BackgroundExecutionManager.RequestAccessAsync 。
BackgroundTaskCancellationReason	指定取消后台任务的原因。
BackgroundTaskThrottleCounter	指示在 GetThrottleCount 请求中检查的限制计数的类型。
BackgroundWorkCostValue	指示当前执行后台工作的成本。 用作后台任务的提示，提示他们可以完成多少工作。
CustomSystemEventTriggerRecurrence	指定何时可以激活 CustomSystemEventTrigger 。
DeviceTriggerResult	指示是允许还是拒绝设备后台任务操作，如果拒绝，则指定原因。
EnergyUseLevel	使应用能够计划后台任务以在应用挂起时运行应用代码。 后台任务适用于不需要用户交互或处理 Toast 操作的小型工作项。 适合后台任务的方案包括下载邮件、显示传入聊天邮件的 Toast 通知，或对系统条件中的更改做出反应。 有关实现 后台任务的指导，请参阅使用 JavaScript 和 HTML) ( 后台任务支持应用或使用后台任务支持应用 。 有关演示如何实现后台任务的示例代码，请参阅 后台任务示例。
LocationTriggerType	指示位置后台任务触发器的位置事件类型。
MediaProcessingTriggerResult	指定调用 MediaProcessingTrigger.RequestAsync 的结果。
SystemConditionType	指定一个系统条件，该条件必须生效才能运行后台任务。 如果触发了具有系统条件的后台任务，则在满足条件之前不会运行该任务。
SystemTriggerType	指定可用于触发后台任务的系统事件。

委托

BackgroundTaskCanceledEventHandler	表示处理取消后台任务的方法。
BackgroundTaskCompletedEventHandler	表示处理后台任务的完成事件的方法。
BackgroundTaskProgressEventHandler	表示处理后台任务的进度更新事件的方法。

另请参阅

• 后台任务示例 (Windows 10)
• 扩展执行示例 (Windows 10)
• 自定义 USB 设备示例 (Windows 10)
• 通信阻止和筛选示例
• 后台激活示例
• DatagramSocket 示例
• StreamSocket 示例
• 版本自适应代码示例