NetworkOperatorDataUsageTrigger Classe

Définition

Espace de noms:

Windows.ApplicationModel.Background

Représente un déclencheur qui lance une tâche en arrière-plan lorsque les compteurs de données locaux estiment que l’utilisation (octets envoyés et reçus) sur l’interface haut débit mobile a changé d’un seuil actionnable.

Notes

Cette fonctionnalité n’est disponible que pour les applications d’opérateur mobile et les applications UWP disposant d’un accès privilégié par les opérateurs de réseau mobile.

Si vous souhaitez utiliser cette API et publier votre application dans le Microsoft Store, vous aurez besoin d’une approbation spéciale. Pour plus d’informations, consultez la section Fonctionnalités restreintes dans la rubrique Déclarations des fonctionnalités d’application et Haut débit mobile.

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

Héritage

Object Platform::Object IInspectable NetworkOperatorDataUsageTrigger

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implémente

IBackgroundTrigger

Configuration requise pour Windows

Famille d’appareils	Windows 10, version 1803 (introduit dans 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v6.0)
Fonctionnalités de l’application	networkDataPlanProvisioning

Remarques

Le déclencheur s’active lorsque les compteurs de données locaux estiment que l’utilisation a changé de 5 % depuis la dernière occurrence, sauf dans ces cas.

1. Si vous êtes connecté à un réseau domestique (non itinérant) et que la limite de votre plan de données n’a pas été spécifiée, ce déclencheur s’active à chaque 100 Mo d’utilisation locale des données.
2. Si vous êtes connecté à un réseau itinérant, la limite de votre plan de données ne s’applique pas et cela déclenche des activités à chaque fois que 5 Mo d’utilisation des données locales.

Lorsque ce déclencheur est activé, IBackgroundTaskInstance.TriggerDetails pour la tâche en arrière-plan est un instance NetworkOperatorDataUsageTriggerDetails.

NetworkOperatorDataUsageTrigger remplace l’utilisation de NetworkOperatorNotificationTrigger et la gestion d’une valeur DataPlanThresholdReached pour NetworkOperatorEventMessageType. Vous pouvez inscrire NetworkOperatorDataUsageTrigger à l’aide d’idiomes de déclencheur d’arrière-plan standard (voir Inscrire une tâche en arrière-plan), et il a les mêmes prérequis que NetworkOperatorNotificationTrigger. Votre application d’opérateur mobile doit toujours provisionner un plan de données et définir DataUsageInMobileOperatorNotificationEnabled sur true. Pour plus d’informations, consultez Les détails techniques de l’événement de notification de l’opérateur mobile .

Constructeurs

NetworkOperatorDataUsageTrigger()

Initialise une nouvelle instance d’un déclencheur d’utilisation des données de l’opérateur de réseau mobile. Notes Cette fonctionnalité n’est disponible que pour les applications d’opérateur mobile et les applications UWP disposant d’un accès privilégié par les opérateurs de réseau mobile. Si vous souhaitez utiliser cette API et publier votre application dans le Microsoft Store, vous aurez besoin d’une approbation spéciale. Pour plus d’informations, consultez la section Fonctionnalités restreintes dans la rubrique Déclarations des fonctionnalités d’application et Haut débit mobile.

Voir aussi

• IBackgroundTrigger