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	表示只有在系統連接到 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 時引發的觸發程式。