Windows.ApplicationModel.Background 命名空間
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
可讓應用程式排程背景工作以執行應用程式程式碼，即使應用程式已暫停亦然。
背景工作適用于不需要使用者互動或處理快顯通知動作的小型工作專案。 適用于背景工作的案例包括下載郵件、顯示傳入聊天訊息的快顯通知，或回應系統條件中的變更。
如需實作背景工作的指引，請參閱 使用 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 平臺 Agent Activation Runtime (AAR) 處理數位助理通訊。 |
| CustomSystemEventTrigger |
這個類別可讓您指定自訂系統觸發程式，以便註冊自訂系統觸發程式，並在系統觸發時回應。 |
| DeviceConnectionChangeTrigger |
表示當裝置的線上狀態變更時啟動背景工作的觸發程式。 |
| DeviceManufacturerNotificationTrigger |
表示啟動背景工作的觸發程式，以啟用裝置製造商作業。 |
| DeviceServicingTrigger |
表示應用程式可以觸發的事件，以起始裝置 (韌體或設定) 長時間執行的更新。 Windows 8.1可讓您為透過 USB、HID 和藍牙通訊的周邊裝置開發 UWP 應用程式。 例如，使用者可能需要將電腦上的內容同步至裝置或從裝置同步處理，或執行裝置本身的長時間執行更新，例如設定或韌體更新。 Windows 8.1提供兩個背景工作和對應的 API，可讓您的裝置在背景同步和更新：DeviceServicingTrigger 和 DeviceUseTrigger。 本主題提供 DeviceServicingTrigger 的 API 參考資訊 - 如需在裝置應用程式內容中使用此觸發程式的資訊，請參閱 UWP 裝置應用程式的裝置同步和更新。 DeviceServicingTrigger 背景工作可讓您的 UWP app 與您的周邊裝置互動，以在 app 暫停時執行長時間執行的裝置更新，例如設定傳輸或韌體更新。 在背景更新您的裝置時，每次使用背景工作時，都需要使用者核准。 不同于 DeviceUseTrigger 背景工作，DeviceServicingTrigger 背景工作允許裝置重新開機和中斷連線，並允許最多 30 分鐘的背景活動。
重要 此觸發程式無法與單一進程背景工作搭配使用。 |
| DeviceUseTrigger |
表示Windows 執行階段應用程式可以觸發的事件，以使用裝置或感應器起始長時間執行的作業。 DeviceUseTrigger可讓您Windows 執行階段應用程式存取背景中的感應器和周邊裝置，即使前景應用程式已暫止亦然。 例如，根據您的 App 在何處執行而定，它能夠使用背景工作，將資料與裝置或監視感應器同步。 這個類別可用於 UWP app 和 Windows Phone 8.x app。 不過， 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 |
表示 SMS 訊息送達時所引發的觸發程式。 |
| SocketActivityTrigger |
表示啟動處理通訊端活動之背景工作的觸發程式。 |
| StorageLibraryChangeTrackerTrigger |
表示 StorageFolder 內的檔案變更，觸發要執行的背景工作。 |
| StorageLibraryContentChangedTrigger |
建立觸發程式，此觸發程式會在指定的程式庫中變更檔案時引發。 |
| SystemCondition |
表示必須生效的系統條件，背景工作才能執行。 |
| SystemTrigger |
表示觸發背景工作執行的系統事件。 |
| TetheringEntitlementCheckTrigger |
表示觸發背景工作執行之系結事件。 |
| TimeTrigger |
表示觸發背景工作執行的時間事件。 |
| ToastNotificationActionTrigger |
表示當使用者在互動式快顯通知上執行動作時，導致背景工作執行的事件。 |
| ToastNotificationHistoryChangedTrigger |
表示當清除應用程式的快顯通知歷程記錄、將一或多個快顯通知新增至代理程式更新或從應用程式的通知歷程記錄中移除，或當應用程式的一或多個快顯通知到期且從通知歷程記錄中移除時，導致背景工作執行的事件。 |
| UserNotificationChangedTrigger |
表示新增或移除 UserNotification 時引發的觸發程式。 |
| WiFiOnDemandHotspotConnectTrigger |
表示當使用者想要連線到特定隨選熱點網路時，導致背景工作執行的事件。 您的背景工作程式碼應該將 IBackgroundTaskInstance.TriggerDetails 屬性的值轉換成 WiFiOnDemandHotspotConnectTriggerDetails。 注意 如果您想要在 UWP 應用程式中使用此 API，並將您的應用程式發佈至 Microsoft Store，則必須要求特殊核准，才能使用自訂功能 Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (隨選網路功能) 。 如需詳細資訊，請參閱 自訂功能。 隨選網路功能只會提供給應用程式開發人員使用，以建置可連線的硬體裝置與 Windows 電腦之間的端對端 Wi-Fi 熱點案例。 |
| WiFiOnDemandHotspotUpdateMetadataTrigger |
表示當使用者開啟作業系統 (OS) 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 |
表示觸發程式事件的基底介面。 |
列舉
| AlarmAccessStatus |
指出使用者是否具有應用程式設定警示的許可權。 |
| ApplicationTriggerResult |
觸發背景工作的要求結果。 RequestAsync方法會傳回這個列舉型別的值。 |
| BackgroundAccessRequestKind |
指定應用程式可以要求的背景活動層級。 |
| BackgroundAccessStatus |
此列舉會指定應用程式執行背景活動的能力。
|
| BackgroundTaskCancellationReason |
指定取消背景工作的原因。 |
| BackgroundTaskThrottleCounter |
指出在 GetThrottleCount 要求中檢查的節流計數類型。 |
| BackgroundWorkCostValue |
表示目前執行背景工作的成本。 做為背景工作的提示，其可以執行多少工作。 |
| CustomSystemEventTriggerRecurrence |
指定何時可以啟動 CustomSystemEventTrigger 。 |
| DeviceTriggerResult |
指出是否允許或拒絕裝置背景工作作業，以及是否遭到拒絕指定原因。 |
| EnergyUseLevel |
可讓應用程式排程背景工作以執行應用程式程式碼，即使應用程式已暫停亦然。 背景工作適用于不需要使用者互動或處理快顯通知動作的小型工作專案。 適用于背景工作的案例包括下載郵件、顯示傳入聊天訊息的快顯通知，或回應系統條件中的變更。 如需實作背景工作的指引，請參閱 使用 JavaScript 和 HTML ( 支援您的應用程式) 或 支援您的應用程式與背景工作 。 如需示範如何實作背景工作的範例程式碼，請參閱 背景工作範例。 |
| LocationTriggerType |
指出位置背景工作觸發程式的位置事件種類。 |
| MediaProcessingTriggerResult |
指定對 MediaProcessingTrigger.RequestAsync的呼叫結果。 |
| SystemConditionType |
指定必須生效的系統條件，才能執行背景工作。 如果觸發了具有系統條件的背景工作，工作將不會執行，直到符合條件為止。 |
| SystemTriggerType |
指定可用來觸發背景工作的系統事件。 |
委派
| BackgroundTaskCanceledEventHandler |
表示處理背景工作取消的方法。 |
| BackgroundTaskCompletedEventHandler |
表示處理背景工作完成事件的方法。 |
| BackgroundTaskProgressEventHandler |
表示處理背景工作進度更新事件的方法。 |