共用方式為


BackgroundTaskBuilder.SetTrigger(IBackgroundTrigger) 方法

定義

設定背景工作的事件觸發程式。

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

事件觸發程式的實例,例如 SystemTriggerTimeTriggerNetworkOperatorNotificationTrigger

備註

除了指定背景工作的事件觸發程式類型之外,應用程式也必須啟用在資訊清單區段中使用事件觸發程式類型的 <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 表示只有在系統連接到 AC 電源時才會執行的維護觸發程式。
MediaProcessingTrigger 表示啟動執行媒體處理之背景工作的觸發程式。
MobileBroadbandDeviceServiceNotificationTrigger 表示網路傳送 SIM 工具命令時啟動的觸發程式。 接收此通知的應用程式接著會處理 SIM 工具命令。
MobileBroadbandPcoDataChangeTrigger 表示行動通訊協定組態選項變更事件,此事件會觸發要執行的背景工作。
MobileBroadbandPinLockStateChangeTrigger 表示觸發程式,指出 SIM PIN 鎖定狀態何時變更。
MobileBroadbandRadioStateChangeTrigger 表示觸發程式,指出行動寬頻無線電狀態何時變更。 例如,當行動裝置轉換到飛機模式或從飛機模式轉換時,就會啟動此觸發程式。
MobileBroadbandRegistrationStateChangeTrigger 表示觸發程式,指出行動寬頻註冊狀態何時變更。 例如,當行動裝置轉換至漫遊或移出漫遊時,就會啟動此觸發程式。
NetworkOperatorDataUsageTrigger 表示當本機資料計數器估計行動寬頻介面上傳送和接收 (位元組使用量已因可採取動作閾值而變更) 時,啟動背景工作的觸發程式。
NetworkOperatorHotspotAuthenticationTrigger 表示行動網路操作員熱點驗證觸發程式。
NetworkOperatorNotificationTrigger 表示行動網路操作員通知觸發程式。
PaymentAppCanMakePaymentTrigger 代表 PaymentAppCanMakePayment 觸發程式。
PhoneTrigger 表示觸發背景工作的電話事件。
PushNotificationTrigger 表示觸發程式,此觸發程式會叫用應用程式上的背景工作專案,以回應原始通知的收據。
RcsEndUserMessageAvailableTrigger 表示當新的 Rich Communication Services (RCS) 訊息可用時,啟動背景工作的觸發程式。
RfcommConnectionTrigger 表示建立 RFCOMM 輸入和輸出連線時啟動背景工作的觸發程式。
SecondaryAuthenticationFactorAuthenticationTrigger 代表代表隨附裝置啟動背景工作的觸發程式。
SensorDataThresholdTrigger 表示在超過感應器閾值限制時回應的觸發程式。
SmartCardTrigger 表示智慧卡所觸發的事件。
SmsMessageReceivedTrigger 表示 SMS 訊息送達時所引發的觸發程式。
SocketActivityTrigger 表示啟動處理通訊端活動之背景工作的觸發程式。
StorageLibraryChangeTrackerTrigger 表示 StorageFolder 內的檔案變更,該資料夾會觸發要執行的背景工作。
StorageLibraryContentChangedTrigger 建立觸發程式,此觸發程式會在指定的程式庫中變更檔案時引發。
SystemCondition 表示必須生效才能執行背景工作的系統條件。
SystemTrigger 表示觸發背景工作執行的系統事件。
TetheringEntitlementCheckTrigger 表示觸發背景工作執行之線上活動。
TimeTrigger 表示觸發背景工作執行的時間事件。
ToastNotificationActionTrigger 表示當使用者在互動式快顯通知上執行動作時,導致背景工作執行的事件。
ToastNotificationHistoryChangedTrigger 表示當清除應用程式的快顯通知歷程記錄、將一或多個快顯通知新增至代理程式更新歷程記錄或從應用程式的通知歷程記錄中移除,或當應用程式的一或多個快顯通知過期且從通知歷程記錄中移除時,導致背景工作執行的事件。
UserNotificationChangedTrigger 表示新增或移除 UserNotification 時引發的觸發程式。

適用於