Partager via


Windows.ApplicationModel.Background Espace de noms

Permet à une application de planifier des tâches en arrière-plan pour exécuter le code de l’application même lorsque l’application est suspendue.

Les tâches en arrière-plan sont destinées aux petits éléments de travail qui ne nécessitent pas d’interaction utilisateur ou à la gestion des actions toast. Les scénarios appropriés pour les tâches en arrière-plan incluent le téléchargement de messages électroniques, l’affichage d’une notification toast pour un message de conversation entrant ou la réaction à une modification d’une condition système.

Consultez Prise en charge de votre application avec des tâches en arrière-plan (à l’aide de JavaScript et html) ou Prise en charge de votre application avec des tâches en arrière-plan pour obtenir des conseils sur l’implémentation de tâches en arrière-plan. Pour obtenir un exemple de code qui montre comment implémenter des tâches en arrière-plan, consultez l’exemple de tâche en arrière-plan.

Classes

ActivitySensorTrigger

Représente un déclencheur qui est activé lorsque le activitySensor reçoit une entrée. Il est utilisé lorsque votre application doit répondre au capteur d’activité.

AlarmApplicationManager

Demande à l’utilisateur l’autorisation de définir des alarmes et récupère le status d’autorisation utilisateur pour que l’application définisse des alarmes.

AppBroadcastTrigger

Représente un événement qui déclenche l’exécution d’une tâche en arrière-plan lorsqu’une application démarre la diffusion du jeu.

AppBroadcastTriggerProviderInfo

Fournit des informations sur l’application qui diffuse le gameplay, telles que son logo, son nom d’affichage et ses caractéristiques vidéo.

ApplicationTrigger

Cela vous permet de déclencher par programmation une tâche en arrière-plan à partir de votre application.

ApplicationTriggerDetails

Détails d’un ApplicationTrigger.

AppointmentStoreNotificationTrigger

Représente un déclencheur qui lance une tâche en arrière-plan pour le traitement des modifications apportées au magasin de rendez-vous.

BackgroundExecutionManager

Gérer l’autorisation d’exécuter des tâches en arrière-plan.

BackgroundTaskBuilder

Représente une tâche en arrière-plan à inscrire auprès du système.

BackgroundTaskCompletedEventArgs

Représente les informations d’achèvement d’une tâche au moment de l’envoi d’une notification d’achèvement.

BackgroundTaskDeferral

Représente un report de tâche en arrière-plan retourné par la méthode IBackgroundTaskInstance.GetDeferral .

BackgroundTaskProgressEventArgs

Représente des informations sur la progression d’une tâche au moment de l’envoi d’une notification de mise à jour de progression.

BackgroundTaskRegistration

Représente une tâche en arrière-plan qui a été inscrite auprès du système.

BackgroundTaskRegistrationGroup

Fournit une sémantique de regroupement afin que l’inscription des tâches en arrière-plan puisse être conservée séparément.

BackgroundWorkCost

Récupère un indicateur sur la disponibilité des ressources pour les tâches en arrière-plan. Les tâches en arrière-plan peuvent utiliser cet indicateur pour déterminer la quantité de travail à effectuer lorsqu’elles sont activées.

BluetoothLEAdvertisementPublisherTrigger

Représente un déclencheur inscrit pour publier une publication Bluetooth LE en arrière-plan.

BluetoothLEAdvertisementWatcherTrigger

Représente un déclencheur inscrit pour rechercher la publication Bluetooth LE en arrière-plan.

CachedFileUpdaterTrigger

Représente un déclencheur qui lance une tâche en arrière-plan pour activer le contrat de mise à jour de fichiers mis en cache.

CachedFileUpdaterTriggerDetails

Fournit des détails sur l’opération de fichier mis en cache qui a appelé le déclencheur.

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. Pour plus d’informations sur le filtrage des messages, consultez Windows.ApplicationModel.CommunicationBlocking.

CommunicationBlockingAppSetAsActiveTrigger

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.

Un utilisateur peut avoir plusieurs applications bloquant les communications installées en même temps. Ce déclencheur est utilisé pour indiquer à une application qu’elle a été sélectionnée comme application active de blocage des communications. Pour plus d’informations sur l’API de blocage des communications, consultez Windows.ApplicationModel.CommunicationBlocking.

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.

ConversationalAgentTrigger

Représente un déclencheur qui lance une tâche en arrière-plan pour le traitement de la communication assistant numérique via le runtime d’activation de l’agent de plateforme Windows (AAR).

CustomSystemEventTrigger

Cette classe vous permet de spécifier un déclencheur système personnalisé afin de pouvoir l’inscrire et répondre lorsqu’il est déclenché par le système.

DeviceConnectionChangeTrigger

Représente un déclencheur qui lance une tâche en arrière-plan lorsque la connexion status d’un appareil change.

DeviceManufacturerNotificationTrigger

Représente un déclencheur qui lance une tâche en arrière-plan pour activer les opérations du fabricant de l’appareil.

DeviceServicingTrigger

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.

Windows 8.1 vous permet de développer une application UWP pour vos périphériques qui communiquent via USB, HID et Bluetooth. Par exemple, un utilisateur peut avoir besoin de synchroniser le contenu d’un PC vers ou à partir de l’appareil, ou d’effectuer une mise à jour de longue durée de l’appareil lui-même, comme les mises à jour des paramètres ou du microprogramme. Windows 8.1 fournit deux tâches en arrière-plan et les API correspondantes qui permettent à votre appareil de synchroniser et de mettre à jour en arrière-plan : DeviceServicingTrigger et DeviceUseTrigger. Cette rubrique fournit des informations de référence d’API pour DeviceServicingTrigger. Pour plus d’informations sur l’utilisation de ce déclencheur dans le contexte d’une application d’appareil, consultez Synchronisation et mise à jour d’appareils pour les applications d’appareil UWP.

La tâche en arrière-plan DeviceServicingTrigger permet à votre application UWP qui interagit avec votre périphérique d’effectuer des mises à jour d’appareil de longue durée pendant la suspension de votre application, par exemple les transferts de paramètres ou les mises à jour de microprogramme. La mise à jour de votre appareil en arrière-plan nécessite l’approbation de l’utilisateur chaque fois que la tâche en arrière-plan est utilisée. Contrairement à la tâche en arrière-plan DeviceUseTrigger , la tâche en arrière-plan DeviceServicingTrigger permet le redémarrage et la déconnexion de l’appareil et autorise un maximum de 30 minutes d’activité en arrière-plan.

Important

Ce déclencheur ne peut pas être utilisé avec des tâches en arrière-plan à processus unique.

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.

DeviceUseTrigger permet à votre application Windows Runtime d’accéder aux capteurs et périphériques en arrière-plan, même lorsque votre application au premier plan est suspendue. Par exemple, en fonction du lieu où votre application s’exécute, elle peut utiliser une tâche en arrière-plan pour synchroniser les données et les périphériques ou surveiller les capteurs.

Cette classe peut être utilisée dans l’application UWP et Windows Phone application 8.x. Toutefois, une tâche en arrière-plan DeviceUseTrigger prend en charge différentes API et est soumise à des stratégies différentes, selon l’endroit où elle s’exécute (PC ou téléphone). Pour en savoir plus sur ces différences, consultez Accès aux capteurs et aux appareils à partir d’une tâche en arrière-plan.

Important

Ce déclencheur ne peut pas être utilisé avec des tâches en arrière-plan à processus unique.

Pour obtenir un exemple qui montre comment utiliser DeviceUseTrigger sur un PC, consultez l’exemple de périphérique USB personnalisé. Pour obtenir un exemple de téléphone, consultez l’exemple Capteurs d’arrière-plan.

DeviceWatcherTrigger

Représente un événement qui provoque l’exécution d’une tâche en arrière-plan lorsque des modifications sont apportées à la liste des appareils. Retourné par GetBackgroundTrigger.

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.

GattServiceProviderTriggerResult

Cette classe contient le déclencheur créé par GattServiceProviderTrigger.CreateAsync().

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

MaintenanceTrigger

Représente un déclencheur de maintenance.

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 d’outil SIM. Les applications qui reçoivent cette notification traitent ensuite les commandes de l’outil SIM.

Cette fonctionnalité est disponible uniquement pour les applications d’opérateur mobile et les applications UWP disposant d’un accès privilégié par les opérateurs de réseau mobile. Pour plus d’informations, consultez Haut débit mobile.

MobileBroadbandPcoDataChangeTrigger

Représente un événement de changement 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 CONFIDENTIEL SIM a changé.

Cette fonctionnalité est disponible uniquement pour les applications d’opérateur mobile et les applications UWP disposant d’un accès privilégié par les opérateurs de réseau mobile. Pour plus d’informations, consultez Haut débit mobile.

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.

Cette fonctionnalité est disponible uniquement pour les applications d’opérateur mobile et les applications UWP disposant d’un accès privilégié par les opérateurs de réseau mobile. Pour plus d’informations, consultez Haut débit mobile.

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

Cette fonctionnalité est disponible uniquement pour les applications d’opérateur mobile et les applications UWP disposant d’un accès privilégié par les opérateurs de réseau mobile. Pour plus d’informations, consultez Haut débit mobile.

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é d’un seuil actionnable.

Notes

Cette fonctionnalité n’est disponible que pour les applications d’opérateur mobile et les applications UWP disposant d’un accès privilégié par les opérateurs de réseau mobile.

Si vous souhaitez utiliser cette API et publier votre application dans le Microsoft Store, vous aurez besoin d’une approbation spéciale. Pour plus d’informations, consultez la section Fonctionnalités restreintes dans la rubrique Déclarations des fonctionnalités d’application et Haut débit mobile.

NetworkOperatorHotspotAuthenticationTrigger

Représente un déclencheur d’authentification du point d’accès de l’opérateur de réseau mobile.

Notes

Une application ne peut instancier cet objet et s’inscrire à l’événement d’authentification de point d’accès qu’après avoir provisionné un profil WLAN qui référence cette application pour gérer l’authentification de point d’accès. Pour plus d’informations, consultez Intégration de Windows 8 pour les opérateurs de point d’accès sans fil.

NetworkOperatorNotificationTrigger

Représente un déclencheur de notification d’opérateur de réseau mobile.

PaymentAppCanMakePaymentTrigger

Cette classe 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 objet 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 une carte intelligente.

SmsMessageReceivedTrigger

Représente un déclencheur déclenché lorsqu’un message 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 en vigueur pour qu’une tâche en arrière-plan s’exécute.

SystemTrigger

Représente un événement système qui déclenche une tâche en arrière-plan à exécuter.

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

WiFiOnDemandHotspotConnectTrigger

Représente un événement qui provoque l’exécution d’une tâche en arrière-plan lorsque l’utilisateur souhaite se connecter à un réseau de point d’accès à la demande spécifique.

Votre code de tâche en arrière-plan doit caster la valeur de la propriété IBackgroundTaskInstance.TriggerDetails en WiFiOnDemandHotspotConnectTriggerDetails.

Notes

Si vous souhaitez utiliser cette API dans une application UWP et publier votre application sur le Microsoft Store, vous devez demander une approbation spéciale pour utiliser la fonctionnalité personnalisée Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (fonctionnalité réseau à la demande). Pour plus d’informations, consultez Fonctionnalités personnalisées.

La fonctionnalité réseau à la demande sera mise à la disposition uniquement des développeurs d’applications qui créent des scénarios de Wi-Fi de bout en bout entre un appareil matériel compatible et un PC Windows.

WiFiOnDemandHotspotUpdateMetadataTrigger

Représente un événement qui provoque l’exécution d’une tâche en arrière-plan lorsque l’utilisateur ouvre la liste du système d’exploitation Wi-Fi réseau, comme pour se connecter à un nouveau réseau Wi-Fi.

Notes

Si vous souhaitez utiliser cette API dans une application UWP et publier votre application sur le Microsoft Store, vous devez demander une approbation spéciale pour utiliser la fonctionnalité personnalisée Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (fonctionnalité réseau à la demande). Pour plus d’informations, consultez Fonctionnalités personnalisées.

La fonctionnalité réseau à la demande sera mise à la disposition uniquement des développeurs d’applications qui créent des scénarios de Wi-Fi de bout en bout entre un appareil matériel compatible et un PC Windows.

Interfaces

IBackgroundCondition

Utilisé pour appliquer le type d’objet de condition système.

IBackgroundTask

Fournit une méthode pour effectuer le travail d’une tâche en arrière-plan.

IBackgroundTaskInstance

Fournit l’accès à une tâche en arrière-plan instance.

IBackgroundTaskInstance2

Fournit l’accès à une tâche en arrière-plan instance. Hérite de l’interface IBackgroundTaskInstance et ajoute la méthode GetThrottleCount .

IBackgroundTaskInstance4

Permet d’accéder à une tâche en arrière-plan instance y compris des informations sur l’utilisateur.

IBackgroundTaskRegistration

Fournit l’accès à une tâche en arrière-plan inscrite.

IBackgroundTaskRegistration2

Fournit l’accès à une tâche en arrière-plan inscrite. Hérite de l’interface IBackgroundTaskRegistration et ajoute la propriété Trigger .

IBackgroundTaskRegistration3

Représente une tâche en arrière-plan qui a été inscrite dans un groupe de tâches en arrière-plan associées.

IBackgroundTrigger

Représente l’interface de base pour les événements de déclencheur.

Énumérations

AlarmAccessStatus

Indique si l’utilisateur a donné l’autorisation à l’application de définir des alarmes.

ApplicationTriggerResult

Résultat de la demande de déclenchement d’une tâche en arrière-plan. La méthode RequestAsync retourne une valeur de ce type d’énumération.

BackgroundAccessRequestKind

Spécifie le niveau d’activité en arrière-plan qu’une application peut demander.

BackgroundAccessStatus

Cette énumération spécifie la capacité d’une application à effectuer une activité en arrière-plan.

Les applications doivent appeler backgroundExecutionManager.RequestAccessAsync avant d’inscrire les tâches en arrière-plan.

BackgroundTaskCancellationReason

Spécifie les raisons de l’annulation d’une tâche en arrière-plan.

BackgroundTaskThrottleCounter

Indique le type de nombre de limitations à case activée dans une requête GetThrottleCount.

BackgroundWorkCostValue

Indique le coût actuel du travail en arrière-plan. Utilisé comme indicateur pour les tâches en arrière-plan sur la quantité de travail qu’elles peuvent effectuer.

CustomSystemEventTriggerRecurrence

Spécifie quand un CustomSystemEventTrigger peut être activé.

DeviceTriggerResult

Indique si l’opération de tâche en arrière-plan de l’appareil a été autorisée ou refusée, et si elle a été refusée spécifie la raison.

EnergyUseLevel

Permet à une application de planifier des tâches en arrière-plan pour exécuter le code de l’application même lorsque l’application est suspendue.

Les tâches en arrière-plan sont destinées aux petits éléments de travail qui ne nécessitent pas d’interaction utilisateur ou à la gestion des actions toast. Les scénarios appropriés pour les tâches en arrière-plan incluent le téléchargement de messages électroniques, l’affichage d’une notification toast pour un message de conversation entrant ou la réaction à une modification d’une condition système.

Consultez Prise en charge de votre application avec des tâches en arrière-plan (à l’aide de JavaScript et html) ou Prise en charge de votre application avec des tâches en arrière-plan pour obtenir des conseils sur l’implémentation de tâches en arrière-plan. Pour obtenir un exemple de code qui montre comment implémenter des tâches en arrière-plan, consultez l’exemple de tâche en arrière-plan.

LocationTriggerType

Indique un type d’événement d’emplacement pour un déclencheur de tâche en arrière-plan d’emplacement.

MediaProcessingTriggerResult

Spécifie le résultat d’un appel à MediaProcessingTrigger.RequestAsync.

SystemConditionType

Spécifie une condition système qui doit être en vigueur pour qu’une tâche en arrière-plan s’exécute. Si une tâche en arrière-plan avec une condition système est déclenchée, la tâche ne s’exécutera pas tant que la condition n’est pas remplie.

SystemTriggerType

Spécifie les événements système qui peuvent être utilisés pour déclencher une tâche en arrière-plan.

Délégués

BackgroundTaskCanceledEventHandler

Représente une méthode qui gère l’annulation d’une tâche en arrière-plan.

BackgroundTaskCompletedEventHandler

Représente une méthode qui gère les événements d’achèvement pour une tâche en arrière-plan.

BackgroundTaskProgressEventHandler

Représente une méthode qui gère les événements de mise à jour de progression pour une tâche en arrière-plan.

Voir aussi