Partager via

BackgroundTaskBuilder.SetTrigger(IBackgroundTrigger) Méthode

  • Référence

Définition

Espace de noms:
Windows.ApplicationModel.Background
Modifier

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é.

S’applique à