Windows.ApplicationModel.Background Espace de noms

Permet à une application de planifier des tâches en arrière-plan pour exécuter du code d’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 du courrier électronique, 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 des 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 activé lorsque ActivitySensor reçoit une entrée. Cela 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 l’état de l’autorisation de l’utilisateur pour que l’application définisse des alarmes.

AppBroadcastTrigger

Représente un événement qui déclenche une tâche en arrière-plan à exécuter lorsqu’une application démarre la diffusion de gameplay.

AppBroadcastTriggerProviderInfo

Fournit des informations sur l’application qui diffuse un gameplay tel 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 les informations de progression d’une tâche au moment où une notification de mise à jour de progression est envoyée.

BackgroundTaskRegistration

Représente une tâche en arrière-plan 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 publicité 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 mise en cache qui a appelé le déclencheur.

ChatMessageNotificationTrigger

Représente un déclencheur 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 tout message entrant susceptible d’être filtré 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 préférée.

Un utilisateur peut avoir plusieurs applications bloquantes de communication installées à la fois. Ce déclencheur permet à une application de savoir qu’elle a été sélectionnée comme application de blocage de communication active. 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 des ressources web.

ConversationalAgentTrigger

Représente un déclencheur qui lance une tâche en arrière-plan pour traiter la communication de l’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 l’état de connexion 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 d’appareils.

DeviceServicingTrigger

Représente un événement qu’une application peut déclencher pour lancer une mise à jour longue (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 du contenu sur un PC vers ou depuis l’appareil, ou d’effectuer une mise à jour longue vers l’appareil lui-même, comme les paramètres ou les mises à jour 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 sur l’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 des appareils UWP.

La tâche en arrière-plan DeviceServicingTrigger permet à votre application UWP qui interagit avec votre appareil périphérique d’effectuer des mises à jour d’appareil longues pendant que votre application est suspendue, par exemple les transferts de paramètres ou les mises à jour du 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 de 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 à différentes stratégies, selon l’emplacement d’exécution (PC ou téléphone). Pour en savoir plus sur ces différences, consultez Accéder aux capteurs et 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 montrant comment utiliser DeviceUseTrigger sur un PC, consultez l’exemple d’appareil 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 entraîne l’exécution d’une tâche en arrière-plan lorsque des modifications se produisent sur la liste des appareils. Retourné par GetBackgroundTrigger.

EmailStoreNotificationTrigger

Représente un déclencheur qui active la notification des modifications apportées au magasin de courriers électroniques.

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 BLUETOOTH LE GATT.

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. Ceci est utilisé pour geofencing.

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é n’est disponible que pour les applications d’opérateur mobile et l’application UWP en fonction de l’accès privilégié par les opérateurs de réseau mobile. Pour plus d’informations, consultez Mobile Broadband : .

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 CONFIDENTIEL SIM a changé.

Cette fonctionnalité n’est disponible que pour les applications d’opérateur mobile et l’application UWP en fonction de l’accès privilégié par les opérateurs de réseau mobile. Pour plus d’informations, consultez Mobile Broadband : .

MobileBroadbandRadioStateChangeTrigger

Représente un déclencheur qui indique quand l’état radio haut débit mobile a changé. Par exemple, ce déclencheur s’active lorsqu’un appareil mobile passe en mode avion ou vers celui-ci.

Cette fonctionnalité n’est disponible que pour les applications d’opérateur mobile et l’application UWP en fonction de l’accès privilégié par les opérateurs de réseau mobile. Pour plus d’informations, consultez Mobile Broadband : .

MobileBroadbandRegistrationStateChangeTrigger

Représente un déclencheur qui indique quand l’état d’inscription haut débit mobile a changé. Par exemple, ce déclencheur s’active lorsqu’un appareil mobile passe à l’itinérance ou à partir de l’itinérance.

Cette fonctionnalité n’est disponible que pour les applications d’opérateur mobile et l’application UWP en fonction de l’accès privilégié par les opérateurs de réseau mobile. Pour plus d’informations, consultez Mobile Broadband : .

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.

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 Windows Store, vous aurez besoin d’une approbation spéciale. Pour plus d’informations, consultez la section Fonctionnalités spéciales et restreintes sous Déclarations de fonctionnalités d’application et Haut débit mobile.

NetworkOperatorHotspotAuthenticationTrigger

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

Notes

Une application ne peut instancier cet objet et s’inscrire qu’à l’événement d’authentification de point d’accès après l’approvisionnement d’un profil LOCAL qui fait référence à cette application pour gérer l’authentification de point d’accès. Pour plus d’informations, consultez Windows 8 Intégration 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 téléphonique 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 RICH Communication Services (RCS) 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 dispositif complémentaire.

SensorDataThresholdTrigger

Représente un déclencheur qui répond lorsqu’une limite de seuil pour un capteur est franchie.

SmartCardTrigger

Représente un événement déclenché par une carte à puce.

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é du 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 à une tâche en arrière-plan à exécuter.

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 entraîne 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 entraîne 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 entraîne 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 convertir 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 dans le Microsoft Store, vous devez demander une approbation spéciale pour utiliser la fonctionnalité personnalisée surDemandHotspotControl (la fonctionnalité réseau à la demande). Pour plus d’informations, consultez Fonctionnalités personnalisées.

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

WiFiOnDemandHotspotUpdateMetadataTrigger

Représente un événement qui entraîne 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 s’il s’agit de se connecter à un nouveau réseau Wi-Fi.

Notes

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

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

Structures

BackgroundAlarmApplicationContract

Permet à une application de planifier des tâches en arrière-plan pour exécuter du code d’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 du courrier électronique, 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 des 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.

Interfaces

IBackgroundCondition

Utilisé pour appliquer le type d’objet 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 instance de tâche en arrière-plan.

IBackgroundTaskInstance2

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

IBackgroundTaskInstance4

Fournit l’accès à une instance de tâche en arrière-plan, 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 inscrite dans le cadre d’un groupe de tâches en arrière-plan associées.

IBackgroundTrigger

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

É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 des 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 à rechercher 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’ils peuvent faire.

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.

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 appliquée à une tâche en arrière-plan à exécuter. Si une tâche en arrière-plan avec une condition système est déclenchée, la tâche ne s’exécute 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 d’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