Windows.ApplicationModel.Background 命名空間

可讓應用程式排程背景工作以執行應用程式程式碼，即使應用程式已暫停亦然。

背景工作適用于不需要使用者互動或處理快顯通知動作的小型工作專案。 適用于背景工作的案例包括下載郵件、顯示傳入聊天訊息的快顯通知，或回應系統條件中的變更。

如需實作背景工作的指引，請參閱 使用 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 分鐘的背景活動。 如需 DeviceServicingTrigger 背景工作原則需求的詳細資訊，請參閱此頁面的 區段。 如需使用 DeviceServicingTrigger 的詳細資訊，請參閱 UWP 裝置應用程式的裝置同步和更新。 如需使用 DeviceUseTrigger的相關資訊，請參閱 從背景工作存取感應器和裝置。 重要 此觸發程式無法與單一進程背景工作搭配使用。
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	表示當本機資料計數器估計在行動寬頻介面上傳送和接收的位元組使用量 () 已因可採取動作閾值而變更時，啟動背景工作的觸發程式。 注意 這項功能僅適用于行動電信業者應用程式，以及行動網路操作員提供特殊許可權存取的 UWP 應用程式。 如果您想要使用此 API 並將您的應用程式發佈至 Microsoft Store，則需要特殊核准。 如需詳細資訊，請參閱應用程式功能宣告主題和行動寬頻中的受限制功能一節。
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	此列舉會指定應用程式執行背景活動的能力。 應用程式必須先成功呼叫 BackgroundExecutionManager.RequestAccessAsync ，才能註冊背景工作。
BackgroundTaskCancellationReason	指定取消背景工作的原因。
BackgroundTaskThrottleCounter	指出在 GetThrottleCount 要求中檢查的節流計數類型。
BackgroundWorkCostValue	表示目前執行背景工作的成本。 做為背景工作的提示，其可以執行多少工作。
CustomSystemEventTriggerRecurrence	指定何時可以啟動 CustomSystemEventTrigger 。
DeviceTriggerResult	指出是否允許或拒絕裝置背景工作作業，以及是否遭到拒絕指定原因。
EnergyUseLevel	可讓應用程式排程背景工作以執行應用程式程式碼，即使應用程式已暫停亦然。 背景工作適用于不需要使用者互動或處理快顯通知動作的小型工作專案。 適用于背景工作的案例包括下載郵件、顯示傳入聊天訊息的快顯通知，或回應系統條件中的變更。 如需實作背景工作的指引，請參閱 使用 JavaScript 和 HTML ( 支援您的應用程式) 或 支援您的應用程式與背景工作 。 如需示範如何實作背景工作的範例程式碼，請參閱 背景工作範例。
LocationTriggerType	指出位置背景工作觸發程式的位置事件種類。
MediaProcessingTriggerResult	指定對 MediaProcessingTrigger.RequestAsync的呼叫結果。
SystemConditionType	指定必須生效的系統條件，才能執行背景工作。 如果觸發了具有系統條件的背景工作，工作將不會執行，直到符合條件為止。
SystemTriggerType	指定可用來觸發背景工作的系統事件。

委派

BackgroundTaskCanceledEventHandler	表示處理背景工作取消的方法。
BackgroundTaskCompletedEventHandler	表示處理背景工作完成事件的方法。
BackgroundTaskProgressEventHandler	表示處理背景工作進度更新事件的方法。

另請參閱

• 背景工作範例 (Windows 10)
• 擴充執行範例 (Windows 10)
• 自訂 USB 裝置範例 (Windows 10)
• 通訊封鎖和篩選範例
• 背景啟用範例
• DatagramSocket 範例
• StreamSocket 範例
• 版本調適型程式碼範例