SystemConditionType 枚举

  • 参考

定义

命名空间:
Windows.ApplicationModel.Background
编辑

指定必须生效才能运行后台任务的系统条件。 如果触发了具有系统条件的后台任务，则在满足条件之前不会运行该任务。

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
继承
Enum
SystemConditionType
属性
ContractVersionAttribute

Windows 要求

设备系列
Windows 10 (在 10.0.10240.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

字段

BackgroundWorkCostNotHigh 8

指定后台任务只能在执行后台工作的成本较低时运行。
FreeNetworkAvailable 7

指定后台任务仅当空闲 (非按流量计费的) 网络连接可用时才能运行。
InternetAvailable 3

指定后台任务只能在 Internet 可用时运行。 如果触发了具有 InternetAvailable 条件的 后台任务，并且 Internet 不可用，则在 Internet 再次可用之前，该任务不会运行。 此条件可以省电，因为必须有可用网络才会执行后台任务。 此条件不提供实时激活。

重要

在后台任务上设置 IsNetworkRequested ，以确保网络在后台任务运行时保持正常运行。 这会告知后台任务基础结构在执行任务时保持网络正常运行，即使设备已进入连接待机模式，这样就可以 (HttpClient、 StreamSocket、 DatagramSocket 等调用核心网络 API。) 例如，如果后台任务未设置 IsNetworkRequested，则后台任务在连接待机模式下 (无法访问网络， 当手机屏幕关闭时。)

InternetNotAvailable 4

指定后台任务只能在 Internet 不可用时运行。 如果触发了具有 InternetNotAvailable 条件的 后台任务，并且 Internet 可用，则任务在 Internet 不可用之前不会运行。
Invalid 0

不是有效的条件类型。
SessionConnected 5

指定后台任务只能在用户会话连接时运行。 如果触发了具有 SessionConnected 条件的 后台任务，并且用户会话未登录，则任务将在用户登录时运行。
SessionDisconnected 6

指定仅当用户的会话断开连接时，后台任务才能运行。 如果触发了具有 SessionDisconnected 条件的后台任务，并且用户已登录，则当用户断开远程桌面会话或执行快速用户切换> [！注意]

SessionDisconnected 主要用于远程桌面和快速用户切换的上下文中。 它不应用作用户已注销计算机的通知。
UserNotPresent 2

指定后台任务只能在用户不存在时运行。 如果触发了具有 UserNotPresent 条件的 后台任务，并且用户存在，则在用户变为非活动状态之前，该任务不会运行。
UserPresent 1

指定后台任务只能在用户存在时运行。 如果触发了具有 UserPresent 条件的 后台任务，并且该用户不在，则在用户存在之前不会运行该任务。

适用于

另请参阅