BackgroundTaskBuilder.SetTrigger(IBackgroundTrigger) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Задает триггер события для фоновой задачи.
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. |