Windows.ApplicationModel.Background Espace de noms
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.
|
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
- Exemple de tâche en arrière-plan (Windows 10)
- Exemple d’exécution étendue (Windows 10)
- Exemple de périphérique USB personnalisé (Windows 10)
- Exemple de blocage et de filtrage des communications
- Exemple d’activation en arrière-plan
- Exemple DatagramSocket
- Exemple StreamSocket
- Exemple de code adaptatif de version