Windows.ApplicationModel.Background 命名空间
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
使应用能够计划后台任务以在应用挂起时运行应用代码。
后台任务适用于不需要用户交互或处理 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 分钟的后台活动。
重要 此触发器不能与单进程后台任务一起使用。 |
| 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 |
表示当本地数据计数器估计移动宽带接口上发送和接收) 的字节使用量 (已更改可操作阈值时启动后台任务的触发器。 |
| 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 |
表示触发器事件的基接口。 |
枚举
委托
| BackgroundTaskCanceledEventHandler |
表示处理取消后台任务的方法。 |
| BackgroundTaskCompletedEventHandler |
表示处理后台任务的完成事件的方法。 |
| BackgroundTaskProgressEventHandler |
表示处理后台任务的进度更新事件的方法。 |