Partager via


DeviceUseTrigger Classe

Définition

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 aux 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 à 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 d’appareil USB personnalisé. Pour obtenir un exemple de téléphone, consultez l’exemple Capteurs d’arrière-plan.

public ref class DeviceUseTrigger sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DeviceUseTrigger final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class DeviceUseTrigger final
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DeviceUseTrigger
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class DeviceUseTrigger
function DeviceUseTrigger()
Public NotInheritable Class DeviceUseTrigger
Héritage
Object Platform::Object IInspectable DeviceUseTrigger
Attributs
Implémente

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

Pour plus d’informations sur les exigences de stratégie, consultez Accès aux capteurs et aux appareils à partir d’une tâche en arrière-plan

Avant que votre application ne déclenche une tâche en arrière-plan sur un téléphone, elle doit d’abord appeler BackgroundExecutionManager.RequestAccessAsync pour case activée si l’application est en mesure de demander une tâche en arrière-plan. Cette case activée n’est pas obligatoire lorsque votre application s’exécute sur un PC.

Constructeurs

DeviceUseTrigger()

Constructeur pour DeviceUseTrigger. Ne prend aucun paramètre.

Méthodes

RequestAsync(String)

Déclenche la tâche en arrière-plan et retourne un DeviceTriggerResult indiquant la réussite ou l’échec de la demande de déclencheur. Prend le DeviceInformation.ID de l’appareil ou du capteur auquel la tâche en arrière-plan accède.

RequestAsync(String, String)

Déclenche la tâche en arrière-plan et retourne un DeviceTriggerResult indiquant la réussite ou l’échec de la demande de déclencheur. Prend le DeviceInformation.ID de l’appareil ou du capteur auquel la tâche en arrière-plan accède, et une chaîne facultative spécifique à l’application passée à la tâche en arrière-plan identifiant l’opération à effectuer.

S’applique à

Voir aussi