NetworkOperatorDataUsageTrigger Klasse

Definition

Stellt einen Trigger dar, der eine Hintergrundaufgabe startet, wenn die lokalen Datenzähler schätzen, dass sich die Nutzung (gesendete und empfangene Bytes) auf der mobilen Breitbandschnittstelle um einen umsetzbaren Schwellenwert geändert hat.

Hinweis

Diese Funktionalität ist nur für Apps von Mobilfunkanbietern und UWP-Apps verfügbar, die privilegierten Zugriff von Mobilfunknetzbetreibern erhalten.

Wenn Sie diese API verwenden und Ihre App im Microsoft Store veröffentlichen möchten, benötigen Sie eine spezielle Genehmigung. Weitere Informationen finden Sie im Abschnitt Eingeschränkte Funktionen im Thema App-Funktionsdeklarationen und mobiles Breitband.

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
Vererbung
Object Platform::Object IInspectable NetworkOperatorDataUsageTrigger
Attribute
Implementiert

Windows-Anforderungen

Gerätefamilie
Windows 10, version 1803 (eingeführt in 10.0.17134.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v6.0)
App-Funktionen
networkDataPlanProvisioning

Hinweise

Der Trigger wird aktiviert, wenn die lokalen Datenzähler schätzen, dass sich die Nutzung seit dem letzten Vorkommen um 5 % geändert hat, außer in diesen Fällen.

  1. Wenn Sie mit einem Heimnetzwerk verbunden sind (nicht Roaming) und Ihr Datenplanlimit nicht angegeben wurde, wird dieser Trigger bei jeder lokalen Datennutzung von 100 MB aktiviert.
  2. Wenn Sie mit einem Roamingnetzwerk verbunden sind, gilt ihr Datenplanlimit nicht, und dies löst bei jeder 5 MB lokalen Datennutzung Aktive aus.

Wenn dieser Trigger aktiviert wird, ist IBackgroundTaskInstance.TriggerDetails für die Hintergrundaufgabe ein NetworkOperatorDataUsageTriggerDetails-instance.

NetworkOperatorDataUsageTrigger ist der Ersatz für die Verwendung von NetworkOperatorNotificationTrigger und die Behandlung eines DataPlanThresholdReached-Werts für NetworkOperatorEventMessageType. Sie können NetworkOperatorDataUsageTrigger mithilfe von Standard-Hintergrundtrigger-Idiomen registrieren (siehe Registrieren einer Hintergrundaufgabe), und es hat die gleichen Voraussetzungen wie NetworkOperatorNotificationTrigger. Ihre Mobilfunkanbieter-App muss weiterhin einen Datenplan bereitstellen und DataUsageInMobileOperatorNotificationEnabled auf truefestlegen. Weitere Informationen finden Sie unter Technische Details zu Benachrichtigungsereignissen von Mobilfunkanbietern .

Konstruktoren

NetworkOperatorDataUsageTrigger()

Initialisiert einen neuen instance eines Datennutzungstriggers eines Mobilfunknetzbetreibers.

Hinweis

Diese Funktionalität ist nur für Apps von Mobilfunkanbietern und UWP-Apps verfügbar, die privilegierten Zugriff von Mobilfunknetzbetreibern erhalten.

Wenn Sie diese API verwenden und Ihre App im Microsoft Store veröffentlichen möchten, benötigen Sie eine spezielle Genehmigung. Weitere Informationen finden Sie im Abschnitt Eingeschränkte Funktionen im Thema App-Funktionsdeklarationen und mobiles Breitband.

Gilt für:

Weitere Informationen