NetworkOperatorDataUsageTrigger NetworkOperatorDataUsageTrigger NetworkOperatorDataUsageTrigger NetworkOperatorDataUsageTrigger NetworkOperatorDataUsageTrigger Class

Definition

Represents a trigger that launches a background task when the local data counters estimate that usage (bytes sent and received) on the mobile broadband interface has changed by an actionable threshold.

Note

This functionality is only available to mobile operator apps and UWP apps given privileged access by mobile network operators.

If you want to use this API and publish your app to the Store, you will need special approval. For more information, see the Special and restricted capabilities section under App capability declarations, and Mobile Broadband.

public : sealed class NetworkOperatorDataUsageTrigger : IBackgroundTrigger
struct winrt::Windows::ApplicationModel::Background::NetworkOperatorDataUsageTrigger : IBackgroundTrigger
public sealed class NetworkOperatorDataUsageTrigger : IBackgroundTrigger
Public NotInheritable Class NetworkOperatorDataUsageTrigger Implements IBackgroundTrigger
var networkOperatorDataUsageTrigger = new networkOperatorDataUsageTrigger();
Attributes

Windows 10 requirements

Device family
Windows 10, version 1803 (introduced v10.0.17134.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v6)
Capabilities
networkDataPlanProvisioning

Remarks

The trigger activates when the local data counters estimate that usage has changed by 5% since the last occurrence, except in these cases.

  1. If you're connected to a home network (non-roaming) and your data plan limit hasn't been specified, then this trigger activates at every 100 MB of local data usage.
  2. If you're connected to a roaming network, then your data plan limit doesn't apply and this trigger actives at every 5 MB of local data usage.

When this trigger activates, the IBackgroundTaskInstance.TriggerDetails for the background task is a NetworkOperatorDataUsageTriggerDetails instance.

NetworkOperatorDataUsageTrigger is the replacement for using NetworkOperatorNotificationTrigger and handling a DataPlanThresholdReached value for NetworkOperatorEventMessageType. You can register NetworkOperatorDataUsageTrigger by using standard background trigger idioms (see Register a background task), and it has the same prerequisites as NetworkOperatorNotificationTrigger. Your mobile operator app still needs to provision a data plan and set DataUsageInMobileOperatorNotificationEnabled to true. See Mobile operator notification event technical details for more details.

Constructors

NetworkOperatorDataUsageTrigger() NetworkOperatorDataUsageTrigger() NetworkOperatorDataUsageTrigger() NetworkOperatorDataUsageTrigger() NetworkOperatorDataUsageTrigger()

Initializes a new instance of a mobile network operator data usage trigger.

Note

This functionality is only available to mobile operator apps and UWP apps given privileged access by mobile network operators.

If you want to use this API and publish your app to the Store, you will need special approval. For more information, see the Special and restricted capabilities section under App capability declarations, and Mobile Broadband.

See also