NetworkOperatorDataUsageTrigger 類別

  • 參考

定義

命名空間:
Windows.ApplicationModel.Background
編輯

表示當本機資料計數器估計在行動寬頻介面上傳送和接收的位元組使用量 () 已因可採取動作閾值而變更時，啟動背景工作的觸發程式。

注意

這項功能僅適用于行動電信業者應用程式，以及行動網路操作員提供特殊許可權存取的 UWP 應用程式。

如果您想要使用此 API 並將您的應用程式發佈至 Microsoft Store，則需要特殊核准。 如需詳細資訊，請參閱應用程式功能宣告主題和行動寬頻中的受限制功能一節。

public ref class NetworkOperatorDataUsageTrigger sealed : IBackgroundTrigger
/// [Windows.Foundation.Metadata.Activatable(393216, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 393216)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class NetworkOperatorDataUsageTrigger final : IBackgroundTrigger
[Windows.Foundation.Metadata.Activatable(393216, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 393216)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class NetworkOperatorDataUsageTrigger : IBackgroundTrigger
function NetworkOperatorDataUsageTrigger()
Public NotInheritable Class NetworkOperatorDataUsageTrigger
Implements IBackgroundTrigger
繼承
Object Platform::Object IInspectable NetworkOperatorDataUsageTrigger
屬性
ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute
實作
IBackgroundTrigger

Windows 需求

裝置系列
Windows 10, version 1803 (已於 10.0.17134.0 引進)
API contract
Windows.Foundation.UniversalApiContract (已於 v6.0 引進)
應用程式功能
networkDataPlanProvisioning

備註

觸發程式會在本機資料計數器估計上次發生之後已變更 5% 的使用量時啟動，但在這些情況下除外。

  1. 如果您連線到家用網路 (非漫遊) ，且尚未指定您的通話方案限制，則此觸發程式會每隔 100 MB 的本機資料使用量啟用一次。
  2. 如果您連線到漫遊網路，則您的通話方案限制不會套用，而且此觸發程式會每 5 MB 的本機資料使用量使用一次。

當此觸發程式啟動時，背景工作的 IBackgroundTaskInstance.TriggerDetails 是 NetworkOperatorDataUsageTriggerDetails 實例。

NetworkOperatorDataUsageTrigger是使用NetworkOperatorNotificationTrigger 取代，並處理NetworkOperatorEventMessageType的 DataPlanThresholdReached值。 您可以使用標準背景觸發程式慣用語來註冊 NetworkOperatorDataUsageTrigger (請參閱 註冊背景工作) ，而且其必要條件與 NetworkOperatorNotificationTrigger相同。 您的行動電信業者應用程式仍然需要布建通話方案，並將 DataUsageInMobileOperatorNotificationEnabled 設定為 true 。 如需詳細資訊，請參閱 行動電信業者通知事件技術詳細資料 。

建構函式

NetworkOperatorDataUsageTrigger()

初始化行動網路操作員資料使用觸發程式的新實例。

注意

這項功能僅適用于行動電信業者應用程式，以及行動網路操作員提供特殊許可權存取的 UWP 應用程式。

如果您想要使用此 API 並將您的應用程式發佈至 Microsoft Store，則需要特殊核准。 如需詳細資訊，請參閱應用程式功能宣告主題和行動寬頻中的受限制功能一節。

適用於

另請參閱