Partager via


SystemConditionType Énumération

Définition

Spécifie une condition système qui doit être appliquée 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écute pas tant que la condition n’est pas remplie.

public enum class SystemConditionType
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class SystemConditionType
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum SystemConditionType
var value = Windows.ApplicationModel.Background.SystemConditionType.invalid
Public Enum SystemConditionType
Héritage
SystemConditionType
Attributs

Configuration requise pour Windows

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

Champs

BackgroundWorkCostNotHigh 8

Spécifie que la tâche en arrière-plan ne peut s’exécuter que lorsque le coût d’exécution du travail en arrière-plan est faible.

FreeNetworkAvailable 7

Spécifie que la tâche en arrière-plan ne peut s’exécuter que lorsqu’une connexion réseau gratuite (non limitée) est disponible.

InternetAvailable 3

Spécifie que la tâche en arrière-plan ne peut s’exécuter que lorsque l’Internet est disponible. Si une tâche en arrière-plan avec la condition InternetAvailable est déclenchée et qu’Internet n’est pas disponible, la tâche ne s’exécute pas tant qu’Internet n’est pas à nouveau disponible. Cette condition économise l’alimentation, car la tâche en arrière-plan ne s’exécute pas tant que le réseau n’est pas disponible. Cette condition ne fournit pas d’activation en temps réel.

Important

Définissez IsNetworkRequested sur votre tâche en arrière-plan pour vous assurer que le réseau reste en place pendant l’exécution de la tâche en arrière-plan. Cela indique à l’infrastructure de tâche en arrière-plan de maintenir le réseau actif pendant l’exécution de la tâche, même si l’appareil est entré en mode veille connectée, afin que vous puissiez appeler les API réseau principales (HttpClient, StreamSocket, DatagramSocket, etc.) Si votre tâche en arrière-plan ne définit pas IsNetworkRequested, votre tâche en arrière-plan ne pourra pas accéder au réseau en mode veille connectée (par exemple, lorsque l’écran d’un téléphone est désactivé).

InternetNotAvailable 4

Spécifie que la tâche en arrière-plan ne peut s’exécuter que lorsque l’Internet n’est pas disponible. Si une tâche en arrière-plan avec la condition InternetNotAvailable est déclenchée et qu’Internet est disponible, la tâche ne s’exécute pas tant qu’Internet n’est pas disponible.

Invalid 0

Type de condition non valide.

SessionConnected 5

Spécifie que la tâche en arrière-plan ne peut s’exécuter que lorsque la session de l’utilisateur est connectée. Si une tâche en arrière-plan avec la condition SessionConnected est déclenchée et que la session utilisateur n’est pas connectée, la tâche s’exécute lorsque l’utilisateur se connecte.

SessionDisconnected 6

Spécifie que la tâche en arrière-plan ne peut s’exécuter que lorsque la session de l’utilisateur est déconnectée. Si une tâche en arrière-plan avec la condition SessionDisconnected est déclenchée et que l’utilisateur est connecté, la tâche s’exécute quand l’utilisateur déconnecte la session Bureau à distance ou effectue un basculement> rapide de l’utilisateur [! REMARQUE]

SessionDisconnected est principalement utilisé dans le contexte du Bureau à distance et du basculement rapide des utilisateurs. Il n’est pas destiné à être utilisé comme notification indiquant que l’utilisateur s’est déconnecté de la machine.

UserNotPresent 2

Spécifie que la tâche en arrière-plan ne peut s’exécuter que lorsque l’utilisateur n’est pas présent. Si une tâche en arrière-plan avec la condition UserNotPresent est déclenchée et que l’utilisateur est présent, la tâche ne s’exécute pas tant que l’utilisateur n’est pas inactif.

UserPresent 1

Spécifie que la tâche en arrière-plan ne peut s’exécuter que lorsque l’utilisateur est présent. Si une tâche en arrière-plan avec la condition UserPresent est déclenchée et que l’utilisateur est absent, la tâche ne s’exécute pas tant que l’utilisateur n’est pas présent.

S’applique à

Voir aussi