NetworkOperatorDataUsageTrigger Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет триггер, запускающий фоновую задачу, когда локальные счетчики данных оценивают, что использование (отправленные и полученные байты) в интерфейсе мобильной широкополосной связи изменилось на пороговое значение.
Примечание
Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети.
Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется специальное утверждение. Дополнительные сведения см. в разделе Ограниченные возможности раздела Объявления возможностей приложений и Мобильное широкополосное подключение.
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
- Наследование
- Атрибуты
- Реализации
Требования к Windows
Семейство устройств |
Windows 10, version 1803 (появилось в 10.0.17134.0)
|
API contract |
Windows.Foundation.UniversalApiContract (появилось в v6.0)
|
Возможности приложения |
networkDataPlanProvisioning
|
Комментарии
Триггер активируется, когда локальные счетчики данных оценивают, что использование изменилось на 5 % с момента последнего вхождения, за исключением этих случаев.
- Если вы подключены к домашней сети (не в роуминге) и ограничение плана передачи данных не указано, этот триггер активируется при каждых 100 МБ локального использования данных.
- Если вы подключены к сети в роуминге, ограничение на тарифный план не применяется, и этот триггер активируется при каждых 5 МБ локального использования данных.
При активации этого триггера IBackgroundTaskInstance.TriggerDetails для фоновой задачи является экземпляром NetworkOperatorDataUsageTriggerDetails .
NetworkOperatorDataUsageTrigger является заменой для использования NetworkOperatorNotificationTrigger и обработки значения DataPlanThresholdReached для NetworkOperatorEventMessageType. Вы можете зарегистрировать NetworkOperatorDataUsageTrigger с помощью стандартных идиом фоновых триггеров (см. раздел Регистрация фоновой задачи) и имеет те же предварительные требования, что и NetworkOperatorNotificationTrigger. Приложению мобильного оператора по-прежнему необходимо подготовить план передачи данных и задать для DataUsageInMobileOperatorNotificationEnabled значение true
. Дополнительные сведения см. в разделе Технические сведения о событии уведомления мобильного оператора .
Конструкторы
NetworkOperatorDataUsageTrigger() |
Инициализирует новый экземпляр триггера использования данных оператора мобильной сети. Примечание Эта функция доступна только для приложений мобильных операторов и приложений UWP с привилегированным доступом со стороны операторов мобильной сети. Если вы хотите использовать этот API и опубликовать приложение в Microsoft Store, вам потребуется специальное утверждение. Дополнительные сведения см. в разделе Ограниченные возможности раздела Объявления возможностей приложений и Мобильное широкополосное подключение. |