NetworkOperatorDataUsageTrigger Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.ApplicationModel.Background
Modifica

Rappresenta un trigger che avvia un'attività in background quando i contatori dati locali stimano che l'utilizzo (byte inviati e ricevuti) nell'interfaccia a banda larga mobile è cambiato da una soglia attivabile.

Nota

Questa funzionalità è disponibile solo per le app degli operatori mobili e le app UWP date l'accesso con privilegi dagli operatori di rete mobile.

Se si vuole usare questa API e pubblicare l'app in Microsoft Store, sarà necessaria un'approvazione speciale. Per altre informazioni, vedere la sezione Funzionalità limitate nell'argomento Dichiarazioni di funzionalità app e Banda larga 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
Ereditarietà
Object Platform::Object IInspectable NetworkOperatorDataUsageTrigger
Attributi
ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute
Implementazioni
IBackgroundTrigger

Requisiti Windows

Famiglia di dispositivi
Windows 10, version 1803 (è stato introdotto in 10.0.17134.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v6.0)
Funzionalità dell'app
networkDataPlanProvisioning

Commenti

Il trigger viene attivato quando i contatori dati locali stimano che l'utilizzo è cambiato del 5% dall'ultima occorrenza, ad eccezione di questi casi.

  1. Se si è connessi a una rete domestica (non roaming) e il limite del piano dati non è stato specificato, questo trigger viene attivato ogni 100 MB di utilizzo dei dati locali.
  2. Se si è connessi a una rete roaming, il limite del piano dati non viene applicato e questo trigger viene attivato ogni 5 MB di utilizzo dei dati locali.

Quando questo trigger viene attivato, l'istanza di IBackgroundTaskInstance.TriggerDetails per l'attività in background è un'istanza di NetworkOperatorDataUsageTriggerDetails .

NetworkOperatorDataUsageTrigger è la sostituzione per l'uso di NetworkOperatorNotificationTrigger e la gestione di un valore DataPlanThresholdReached per NetworkOperatorEventMessageType. È possibile registrare NetworkOperatorDataUsageTrigger usando gli idiomi di trigger in background standard (vedere Registrare un'attività in background) e presenta gli stessi prerequisiti di NetworkOperatorNotificationTrigger. L'app per operatori mobili deve comunque effettuare il provisioning di un piano dati e impostare DataUsageInMobileOperatorNotificationEnabled su true. Per altre informazioni, vedere Dettagli tecnici sull'evento di notifica dell'operatore mobile .

Costruttori

NetworkOperatorDataUsageTrigger()

Inizializza una nuova istanza di un trigger di utilizzo dei dati dell'operatore di rete mobile.

Nota

Questa funzionalità è disponibile solo per le app degli operatori mobili e le app UWP date l'accesso con privilegi dagli operatori di rete mobile.

Se si vuole usare questa API e pubblicare l'app in Microsoft Store, sarà necessaria un'approvazione speciale. Per altre informazioni, vedere la sezione Funzionalità limitate nell'argomento Dichiarazioni di funzionalità app e Banda larga mobile.

Si applica a

Vedi anche