BackgroundTaskBuilder.SetTrigger(IBackgroundTrigger) Метод

Определение

Пространство имен:

Windows.ApplicationModel.Background

Задает триггер события для фоновой задачи.

public:
 virtual void SetTrigger(IBackgroundTrigger ^ trigger) = SetTrigger;

void SetTrigger(IBackgroundTrigger const& trigger);

public void SetTrigger(IBackgroundTrigger trigger);

function setTrigger(trigger)

Public Sub SetTrigger (trigger As IBackgroundTrigger)

Параметры

trigger

IBackgroundTrigger

Экземпляр объекта триггера события, например SystemTrigger, TimeTrigger или NetworkOperatorNotificationTrigger.

Комментарии

Помимо указания типа триггера событий для фоновой задачи, приложение также должно включить фоновые задачи, использующие тип триггера события в <Extensions><Extension><BackgroundTasks> разделе своего манифеста. Допустимые типы:

• <Task Type="audio"/>
• <Task Type="timer"/>
• <Task Type="systemEvent"/>
• <Task Type="pushNotification"/>
• <Task Type="realTimeCommunication"/>

Если тип фоновой задачи не указан или указан неправильно в манифесте, вызовы, которые пытаются использовать фоновую задачу такого типа, завершатся ошибкой.

Список триггеров:

Триггер	Описание
ActivitySensorTrigger	Используется, когда приложение должно реагировать на датчик активности.
AppBroadcastTrigger	Активируйте фоновую задачу для запуска, когда приложение начинает трансляцию игрового процесса.
ApplicationTrigger	Активируйте фоновые задачи из приложения.
AppointmentStoreNotificationTrigger	Триггер для запуска фоновой задачи для обработки изменений в хранилище встреч.
BluetoothLEAdvertisementPublisherTrigger	Представляет триггер, зарегистрированный для объявления объявления Bluetooth LE в фоновом режиме.
CachedFileUpdaterTrigger	Активируйте фоновую задачу, чтобы включить контракт кэшированных файлов Updater.
ChatMessageNotificationTrigger	Представляет триггер, активируемый при получении уведомления о текстовом сообщении.
ChatMessageReceivedNotificationTrigger	Представляет триггер, запускающий фоновую задачу, которая обрабатывает любое входящее сообщение, которое может потребоваться отфильтровать в соответствии с его содержимым.
CommunicaionBlockingAppSetAsActiveTrigger	Представляет триггер для активации приложения, блокирующего обмен данными, если оно выбрано в качестве предпочтительного приложения для блокировки.
ContactStoreNotificationTrigger	Представляет триггер, запускающий фоновую задачу для обработки изменений в хранилище контактов.
ContentPrefetchTrigger	Предоставляет возможность запуска пользовательских обработчиков при предварительной выборке веб-ресурсов.
CustomSystemEventTrigger	Настраиваемый системный триггер, который можно определить .
DeviceConnectionChangeTrigger	Представляет событие, которое приложение может активировать для запуска длительного обновления (встроенного ПО или параметров) устройства.
DeviceManufacturerNotificationTrigger	Представляет событие, которое приложение может активировать для запуска длительного обновления (встроенного ПО или параметров) устройства.
DeviceUseTrigger	Представляет событие, которое приложение среда выполнения Windows может активировать для запуска длительной операции с устройством или датчиком.
EmailStoreNotificationTrigger	Представляет триггер, который включает уведомление об изменениях в хранилище электронной почты.
GattCharacteristicNotificationTrigger	Представляет триггер, запускающий фоновую задачу при получении входящего уведомления об изменениях для характеристики Bluetooth LE GATT.
GattServiceProviderTrigger	Создает службу универсальных атрибутов (GATT), которую можно сохранить в фоновом режиме.
GeovisitTrigger	Представляет событие, которое активирует фоновую задачу, связанную с посещениями.
LocationTrigger	Представляет событие расположения, которое активирует фоновую задачу. Используется для геозон.
MaintenanceTrigger	Представляет триггер обслуживания, который запускается только при подключении системы к сети переменного тока.
MediaProcessingTrigger	Представляет триггер, запускающий фоновую задачу для выполнения обработки мультимедиа.
MobileBroadbandDeviceServiceNotificationTrigger	Представляет триггер, который активируется, когда сеть отправляет команды средства SIM-карты. Приложения, получающие это уведомление, затем обрабатывают команды средства SIM-карты.
MobileBroadbandPcoDataChangeTrigger	Представляет событие изменения параметра конфигурации протокола сотовой сети, которое активирует выполнение фоновой задачи.
MobileBroadbandPinLockStateChangeTrigger	Представляет триггер, указывающий, когда изменилось состояние блокировки ПИН-кода SIM-карты.
MobileBroadbandRadioStateChangeTrigger	Представляет триггер, указывающий, когда изменилось состояние мобильной широкополосной радиосвязи. Например, этот триггер активируется, когда мобильное устройство переходит в режим "в самолете" или из нее.
MobileBroadbandRegistrationStateChangeTrigger	Представляет триггер, указывающий, когда изменилось состояние регистрации мобильной широкополосной связи. Например, этот триггер активируется, когда мобильное устройство переходит в роуминг или из нее.
NetworkOperatorDataUsageTrigger	Представляет триггер, запускающий фоновую задачу, когда локальные счетчики данных оценивают, что использование (отправленных и полученных байтов) в интерфейсе мобильной широкополосной связи изменилось на допустимое пороговое значение.
NetworkOperatorHotspotAuthenticationTrigger	Представляет триггер проверки подлинности хот-спота оператора мобильной сети.
NetworkOperatorNotificationTrigger	Представляет триггер уведомления оператора мобильной сети.
PaymentAppCanMakePaymentTrigger	Представляет триггер PaymentAppCanMakePayment.
PhoneTrigger	Представляет событие телефона, которое активирует фоновую задачу.
PushNotificationTrigger	Представляет триггер, который вызывает фоновый рабочий элемент в приложении в ответ на получение необработанного уведомления.
RcsEndUserMessageAvailableTrigger	Представляет триггер, запускающий фоновую задачу, когда доступно новое сообщение Служб коммуникации (RCS).
RfcommConnectionTrigger	Представляет триггер, запускающий фоновую задачу при установке входящих или исходящих подключений RFCOMM.
SecondaryAuthenticationFactorAuthenticationTrigger	Представляет триггер, запускающий фоновую задачу от имени устройства-компаньона.
SensorDataThresholdTrigger	Представляет триггер, который реагирует на превышение порогового значения для датчика.
SmartCardTrigger	Представляет событие, активируется смарт-карта.
SmsMessageReceivedTrigger	Представляет триггер, который возникает при поступлении SMS-сообщения.
SocketActivityTrigger	Представляет триггер, запускающий фоновую задачу для обработки действий сокета.
StorageLibraryChangeTrackerTrigger	Представляет изменение файла в папке StorageFolder, которая запускает фоновую задачу для выполнения.
StorageLibraryContentChangedTrigger	Создает триггер, который срабатывает при изменении файла в указанной библиотеке.
SystemCondition	Представляет системное условие, которое должно действовать для выполнения фоновой задачи.
SystemTrigger	Представляет системное событие, которое запускает фоновую задачу для выполнения.
TetheringEntitlementCheckTrigger	Представляет событие привязки, которое запускает фоновую задачу для выполнения.
TimeTrigger	Представляет событие времени, которое запускает фоновую задачу для выполнения.
ToastNotificationActionTrigger	Представляет событие, которое вызывает выполнение фоновой задачи, когда пользователь выполняет действие с интерактивным всплывляющим уведомлением.
ToastNotificationHistoryChangedTrigger	Представляет событие, которое вызывает выполнение фоновой задачи при очистке журнала всплывающих уведомлений для приложения, при добавлении или удалении одного или нескольких всплывающих уведомлений из журнала уведомлений для приложения или при удалении одного или нескольких всплывающих уведомлений для приложения истечет и удаляются из журнала уведомлений.
UserNotificationChangedTrigger	Представляет триггер, который срабатывает при добавлении или удалении userNotification.