通过

BackgroundTaskBuilder.SetTrigger(IBackgroundTrigger) 方法

  • 参考

定义

命名空间:
Windows.ApplicationModel.Background
编辑

设置后台任务的事件触发器。

public:
 virtual void SetTrigger(IBackgroundTrigger ^ trigger) = SetTrigger;
void SetTrigger(IBackgroundTrigger const& trigger);
public void SetTrigger(IBackgroundTrigger trigger);
function setTrigger(trigger)
Public Sub SetTrigger (trigger As IBackgroundTrigger)

参数

trigger
IBackgroundTrigger

事件触发器对象的实例，例如 SystemTrigger、 TimeTrigger 或 NetworkOperatorNotificationTrigger。

注解

除了为后台任务指定事件触发器的类型外，应用程序还必须在其清单的 节中 <Extensions><Extension><BackgroundTasks> 启用使用事件触发器类型的后台任务。 有效类型包括：

  • <Task Type="audio"/>
  • <Task Type="timer"/>
  • <Task Type="systemEvent"/>
  • <Task Type="pushNotification"/>
  • <Task Type="realTimeCommunication"/>

如果未在清单中指定或未正确指定后台任务类型，则尝试使用此类后台任务的调用将失败。

触发器列表：

触发器 说明
ActivitySensorTrigger 当应用程序需要响应活动传感器时使用。
AppBroadcastTrigger 触发后台任务，在应用程序开始播放广播时运行。
ApplicationTrigger 从应用程序内触发后台任务。
AppointmentStoreNotificationTrigger 触发以启动后台任务以处理对约会存储的更改。
BluetoothLEAdvertisementPublisherTrigger 表示注册以在后台播发蓝牙 LE 播发的触发器。
CachedFileUpdaterTrigger 触发后台任务以启用缓存文件更新程序协定。
ChatMessageNotificationTrigger 表示在有短信通知时激活的触发器。
ChatMessageReceivedNotificationTrigger 表示一个触发器，该触发器启动后台任务，该任务处理可能需要根据其内容筛选的任何传入消息。
CommunicaionBlockingAppSetAsActiveTrigger 表示一个触发器，用于在选择通信阻止应用程序作为首选阻止应用时激活该应用程序。
ContactStoreNotificationTrigger 表示一个触发器，该触发器启动后台任务以处理对联系人存储的更改。
ContentPrefetchTrigger 提供在预提取 Web 资源时运行自定义处理程序的功能。
CustomSystemEventTrigger 可以定义的自定义系统触发器。
DeviceConnectionChangeTrigger 表示应用程序可以触发的事件，以启动长时间运行的更新 (固件或设备设置) 。
DeviceManufacturerNotificationTrigger 表示应用程序可以触发的事件，以启动长时间运行的更新 (固件或设备设置) 。
DeviceUseTrigger 表示Windows 运行时应用可以触发以使用设备或传感器启动长时间运行的操作的事件。
EmailStoreNotificationTrigger 表示启用电子邮件存储更改通知的触发器。
GattCharacteristicNotificationTrigger 表示在收到蓝牙 LE GATT 特征的传入更改通知时启动后台任务的触发器。
GattServiceProviderTrigger (GATT) 服务构造可在后台保留的泛型属性。
GeovisitTrigger 表示触发与 Visits 相关的后台任务的事件。
LocationTrigger 表示触发后台任务的位置事件。 这用于地理围栏。
MaintenanceTrigger 表示仅在系统连接到交流电源时运行的维护触发器。
MediaProcessingTrigger 表示启动后台任务以执行媒体处理的触发器。
MobileBroadbandDeviceServiceNotificationTrigger 表示在网络发送 SIM 工具命令时激活的触发器。 接收此通知的应用随后处理 SIM 工具命令。
MobileBroadbandPcoDataChangeTrigger 表示触发后台任务运行的手机网络协议配置选项更改事件。
MobileBroadbandPinLockStateChangeTrigger 表示指示 SIM PIN 锁定状态何时更改的触发器。
MobileBroadbandRadioStateChangeTrigger 表示指示移动宽带无线电状态何时更改的触发器。 例如，当移动设备转换到飞行模式或从飞行模式转换时，此触发器将激活。
MobileBroadbandRegistrationStateChangeTrigger 表示指示移动宽带注册状态何时更改的触发器。 例如，当移动设备转换到漫游或从漫游转换时，此触发器将激活。
NetworkOperatorDataUsageTrigger 表示当本地数据计数器估计移动宽带接口上发送和接收) 的字节使用量 (已更改可操作阈值时启动后台任务的触发器。
NetworkOperatorHotspotAuthenticationTrigger 表示移动网络运营商热点身份验证触发器。
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 时触发的触发器。

适用于