SystemConditionType Enumeración

Definición

Especifica una condición del sistema que debe estar en vigor para que se ejecute una tarea en segundo plano. Si se desencadena una tarea en segundo plano con una condición del sistema, la tarea no se ejecutará hasta que se cumpla la condición.

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
Herencia
SystemConditionType
Atributos

Requisitos de Windows

Familia de dispositivos
Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Campos

BackgroundWorkCostNotHigh 8

Especifica que la tarea en segundo plano solo se puede ejecutar cuando el costo de realizar el trabajo en segundo plano es bajo.

FreeNetworkAvailable 7

Especifica que la tarea en segundo plano solo se puede ejecutar cuando hay disponible una conexión de red gratuita (sin medición).

InternetAvailable 3

Especifica que la tarea en segundo plano solo se puede ejecutar cuando Internet está disponible. Si se desencadena una tarea en segundo plano con la condición InternetAvailable y Internet no está disponible, la tarea no se ejecutará hasta que Internet vuelva a estar disponible. Esta condición ahorra energía porque la tarea en segundo plano no se ejecutará hasta que la red esté disponible. Esta condición no proporciona una activación en tiempo real.

Importante

Establezca IsNetworkRequested en la tarea en segundo plano para asegurarse de que la red permanece al día mientras se ejecuta la tarea en segundo plano. Esto indica a la infraestructura de tareas en segundo plano que mantenga la red al día mientras se ejecuta la tarea, incluso si el dispositivo ha entrado en modo de espera conectado, para que pueda llamar a las API de red principales (HttpClient, StreamSocket, DatagramSocket, etc.). Si la tarea en segundo plano no establece IsNetworkRequested, la tarea en segundo plano no podrá acceder a la red cuando esté en modo de espera conectado (por ejemplo, cuando la pantalla de un teléfono está desactivada).

InternetNotAvailable 4

Especifica que la tarea en segundo plano solo se puede ejecutar cuando Internet no está disponible. Si se desencadena una tarea en segundo plano con la condición InternetNotAvailable y Internet está disponible, la tarea no se ejecutará hasta que Internet no esté disponible.

Invalid 0

No es un tipo de condición válido.

SessionConnected 5

Especifica que la tarea en segundo plano solo se puede ejecutar cuando la sesión del usuario está conectada. Si se desencadena una tarea en segundo plano con la condición SessionConnected y la sesión del usuario no se inicia sesión, la tarea se ejecutará cuando el usuario inicie sesión.

SessionDisconnected 6

Especifica que la tarea en segundo plano solo se puede ejecutar cuando la sesión del usuario está desconectada. Si se desencadena una tarea en segundo plano con la condición SessionDisconnected y el usuario ha iniciado sesión, la tarea se ejecutará cuando el usuario desconecte la sesión de escritorio remoto o realice un cambio> rápido de usuario [! NOTA]

SessionDisconnected se usa principalmente en el contexto del escritorio remoto y el cambio rápido de usuario. No está pensado para usarse como una notificación de que el usuario ha cerrado la sesión de la máquina.

UserNotPresent 2

Especifica que la tarea en segundo plano solo se puede ejecutar cuando el usuario no está presente. Si se desencadena una tarea en segundo plano con la condición UserNotPresent y el usuario está presente, la tarea no se ejecutará hasta que el usuario se vuelva inactivo.

UserPresent 1

Especifica que la tarea en segundo plano solo se puede ejecutar cuando el usuario está presente. Si se desencadena una tarea en segundo plano con la condición UserPresent y el usuario está ausente, la tarea no se ejecutará hasta que el usuario esté presente.

Se aplica a

Consulte también