BackgroundTaskBuilder.SetTrigger(IBackgroundTrigger) Méthode

Définition

Espace de noms:

Windows.ApplicationModel.Background

Définit le déclencheur d’événement pour une tâche en arrière-plan.

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)

Paramètres

trigger

IBackgroundTrigger

Instance d’un objet déclencheur d’événement tel qu’un Objet SystemTrigger, TimeTrigger ou NetworkOperatorNotificationTrigger.

Remarques

En plus de spécifier le type de déclencheur d’événement pour une tâche en arrière-plan, une application doit également activer les tâches en arrière-plan qui utilisent le type de déclencheur d’événement dans la <Extensions><Extension><BackgroundTasks> section de son manifeste. Les types valides sont les suivants :

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

Si le type de tâche en arrière-plan n’est pas spécifié ou spécifié de manière incorrecte dans le manifeste, les appels qui tentent d’utiliser ce type de tâche en arrière-plan échouent.

Liste des déclencheurs :

Déclencheur	Description
ActivitySensorTrigger	Utilisé lorsque votre application doit répondre au capteur d’activité.
AppBroadcastTrigger	Déclenchez une tâche en arrière-plan à exécuter lorsqu’une application démarre la diffusion du jeu.
ApplicationTrigger	Déclenchez des tâches en arrière-plan à partir de votre application.
AppointmentStoreNotificationTrigger	Déclencheur pour lancer une tâche en arrière-plan pour le traitement des modifications apportées au magasin de rendez-vous.
BluetoothLEAdvertisementPublisherTrigger	Représente un déclencheur inscrit pour publier une publication Bluetooth LE en arrière-plan.
CachedFileUpdaterTrigger	Déclenchez une tâche en arrière-plan pour activer le contrat de mise à jour de fichiers mis en cache.
ChatMessageNotificationTrigger	Représente un déclencheur qui est activé lorsqu’il existe une notification pour un sms.
ChatMessageReceivedNotificationTrigger	Représente un déclencheur qui lance une tâche en arrière-plan qui gère les messages entrants susceptibles de devoir être filtrés en fonction de son contenu.
CommunicaionBlockingAppSetAsActiveTrigger	Représente un déclencheur pour activer une application de blocage de communication lorsqu’elle est sélectionnée comme application de blocage par défaut.
ContactStoreNotificationTrigger	Représente un déclencheur qui lance une tâche en arrière-plan pour le traitement des modifications apportées au magasin de contacts.
ContentPrefetchTrigger	Permet d’exécuter des gestionnaires personnalisés lors de la prérécupération de ressources web.
CustomSystemEventTrigger	Déclencheur système personnalisé que vous pouvez définir.
DeviceConnectionChangeTrigger	Représente un événement qu’une application peut déclencher pour lancer une mise à jour de longue durée (microprogramme ou paramètres) d’un appareil.
DeviceManufacturerNotificationTrigger	Représente un événement qu’une application peut déclencher pour lancer une mise à jour de longue durée (microprogramme ou paramètres) d’un appareil.
DeviceUseTrigger	Représente un événement qu’une application Windows Runtime peut déclencher pour lancer une opération de longue durée avec un appareil ou un capteur.
EmailStoreNotificationTrigger	Représente un déclencheur qui active la notification des modifications apportées au magasin de courrier.
GattCharacteristicNotificationTrigger	Représente un déclencheur qui lance une tâche en arrière-plan lorsqu’une notification de modification entrante est reçue pour une caractéristique GATT Bluetooth LE.
GattServiceProviderTrigger	Construit un service d’attributs génériques (GATT) qui peut être conservé en arrière-plan.
GeovisitTrigger	Représente un événement qui déclenche une tâche en arrière-plan liée aux visites.
LocationTrigger	Représente un événement d’emplacement qui déclenche une tâche en arrière-plan. Il est utilisé pour le géofencing.
MaintenanceTrigger	Représente un déclencheur de maintenance qui s’exécute uniquement lorsque le système est connecté à l’alimentation secteur.
MediaProcessingTrigger	Représente un déclencheur qui lance une tâche en arrière-plan pour effectuer un traitement multimédia.
MobileBroadbandDeviceServiceNotificationTrigger	Représente un déclencheur qui s’active lorsque le réseau envoie des commandes de l’outil SIM. Les applications qui reçoivent cette notification traitent ensuite les commandes de l’outil SIM.
MobileBroadbandPcoDataChangeTrigger	Représente un événement de modification d’option de configuration de protocole cellulaire qui déclenche l’exécution d’une tâche en arrière-plan.
MobileBroadbandPinLockStateChangeTrigger	Représente un déclencheur qui indique quand l’état de verrouillage du code PIN de la carte SIM a changé.
MobileBroadbandRadioStateChangeTrigger	Représente un déclencheur qui indique quand l’état de la radio haut débit mobile a changé. Par exemple, ce déclencheur s’active lorsqu’un appareil mobile effectue une transition vers ou depuis le mode avion.
MobileBroadbandRegistrationStateChangeTrigger	Représente un déclencheur qui indique quand l’état d’inscription du haut débit mobile a changé. Par exemple, ce déclencheur s’active lorsqu’un appareil mobile effectue une transition vers ou depuis l’itinérance.
NetworkOperatorDataUsageTrigger	Représente un déclencheur qui lance une tâche en arrière-plan lorsque les compteurs de données locaux estiment que l’utilisation (octets envoyés et reçus) sur l’interface haut débit mobile a changé par un seuil actionnable.
NetworkOperatorHotspotAuthenticationTrigger	Représente un déclencheur d’authentification du point d’accès de l’opérateur de réseau mobile.
NetworkOperatorNotificationTrigger	Représente un déclencheur de notification d’opérateur de réseau mobile.
PaymentAppCanMakePaymentTrigger	Représente un déclencheur PaymentAppCanMakePayment.
PhoneTrigger	Représente un événement de téléphone qui déclenche une tâche en arrière-plan.
PushNotificationTrigger	Représente un déclencheur qui appelle un élément de travail en arrière-plan sur l’application en réponse à la réception d’une notification brute.
RcsEndUserMessageAvailableTrigger	Représente un déclencheur qui lance une tâche en arrière-plan lorsqu’un nouveau message RCS (Rich Communication Services) est disponible.
RfcommConnectionTrigger	Représente un déclencheur qui lance une tâche en arrière-plan lorsqu’une connexion entrante ou sortante RFCOMM est établie.
SecondaryAuthenticationFactorAuthenticationTrigger	Représente un déclencheur qui lance une tâche en arrière-plan pour le compte d’un appareil complémentaire.
SensorDataThresholdTrigger	Représente un déclencheur qui répond lorsqu’une limite de seuil pour un capteur est dépassée.
SmartCardTrigger	Représente un événement déclenché par un carte intelligent.
SmsMessageReceivedTrigger	Représente un déclencheur déclenché lorsqu’un sms est arrivé.
SocketActivityTrigger	Représente un déclencheur qui lance une tâche en arrière-plan pour gérer l’activité de socket.
StorageLibraryChangeTrackerTrigger	Représente une modification de fichier dans un StorageFolder qui déclenche l’exécution d’une tâche en arrière-plan.
StorageLibraryContentChangedTrigger	Crée un déclencheur qui se déclenche lorsqu’un fichier est modifié dans une bibliothèque spécifiée.
SystemCondition	Représente une condition système qui doit être appliquée pour qu’une tâche en arrière-plan s’exécute.
SystemTrigger	Représente un événement système qui déclenche l’exécution d’une tâche en arrière-plan.
TetheringEntitlementCheckTrigger	Représente un événement de connexion qui déclenche l’exécution d’une tâche en arrière-plan.
TimeTrigger	Représente un événement de temps qui déclenche l’exécution d’une tâche en arrière-plan.
ToastNotificationActionTrigger	Représente un événement qui provoque l’exécution d’une tâche en arrière-plan lorsque l’utilisateur effectue une action sur une notification toast interactive.
ToastNotificationHistoryChangedTrigger	Représente un événement qui provoque l’exécution d’une tâche en arrière-plan lorsque l’historique des notifications toast pour l’application est effacé, lorsqu’une ou plusieurs notifications toast sont ajoutées ou supprimées de l’historique des notifications pour l’application, ou lorsqu’une ou plusieurs notifications toast pour l’application expirent et sont supprimées de l’historique des notifications.
UserNotificationChangedTrigger	Représente un déclencheur qui se déclenche lorsqu’un UserNotification est ajouté ou supprimé.