NetworkOperatorDataUsageTrigger Classe

  • Referência

Definição

Namespace:
Windows.ApplicationModel.Background
Editar

Representa um gatilho que inicia uma tarefa em segundo plano quando os contadores de dados locais estimam que o uso (bytes enviados e recebidos) na interface de banda larga móvel foi alterado por um limite acionável.

Observação

Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativos UWP com acesso privilegiado por operadoras de rede móvel.

Se você quiser usar essa API e publicar seu aplicativo na Microsoft Store, precisará de aprovação especial. Para obter mais informações, consulte a seção Funcionalidades restritas no tópico Declarações de funcionalidade do aplicativo e Banda Larga Móvel.

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
Herança
Object Platform::Object IInspectable NetworkOperatorDataUsageTrigger
Atributos
ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute
Implementações
IBackgroundTrigger

Requisitos do Windows

Família de dispositivos
Windows 10, version 1803 (introduzida na 10.0.17134.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v6.0)
Funcionalidades do aplicativo
networkDataPlanProvisioning

Comentários

O gatilho é ativado quando os contadores de dados locais estimam que o uso foi alterado em 5% desde a última ocorrência, exceto nesses casos.

  1. Se você estiver conectado a uma rede doméstica (não móvel) e o limite do plano de dados não tiver sido especificado, esse gatilho será ativado a cada 100 MB de uso de dados locais.
  2. Se você estiver conectado a uma rede móvel, o limite do plano de dados não se aplicará e esse gatilho será ativo a cada 5 MB de uso de dados locais.

Quando esse gatilho é ativado, a instância IBackgroundTaskInstance.TriggerDetails para a tarefa em segundo plano é uma instância NetworkOperatorDataUsageTriggerDetails .

NetworkOperatorDataUsageTrigger é a substituição por usar NetworkOperatorNotificationTrigger e manipular um valor DataPlanThresholdReached para NetworkOperatorEventMessageType. Você pode registrar NetworkOperatorDataUsageTrigger usando expressões de gatilho padrão em segundo plano (consulte Registrar uma tarefa em segundo plano) e ela tem os mesmos pré-requisitos que NetworkOperatorNotificationTrigger. Seu aplicativo de operadora móvel ainda precisa provisionar um plano de dados e definir DataUsageInMobileOperatorNotificationEnabled como true. Confira Detalhes técnicos do evento de notificação da operadora móvel para obter mais detalhes.

Construtores

NetworkOperatorDataUsageTrigger()

Inicializa uma nova instância de um gatilho de uso de dados da operadora de rede móvel.

Observação

Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativos UWP com acesso privilegiado por operadoras de rede móvel.

Se você quiser usar essa API e publicar seu aplicativo na Microsoft Store, precisará de aprovação especial. Para obter mais informações, consulte a seção Funcionalidades restritas no tópico Declarações de funcionalidade do aplicativo e Banda Larga Móvel.

Aplica-se a

Confira também