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 时触发的触发器。