SystemConditionType 列舉
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
指定必須生效的系統條件,才能執行背景工作。 如果觸發了具有系統條件的背景工作,工作將不會執行,直到符合條件為止。
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
- 繼承
-
SystemConditionType
- 屬性
Windows 需求
裝置系列 |
Windows 10 (已於 10.0.10240.0 引進)
|
API contract |
Windows.Foundation.UniversalApiContract (已於 v1.0 引進)
|
欄位
BackgroundWorkCostNotHigh | 8 | 指定只有在執行背景工作的成本很低時,背景工作才能執行。 |
FreeNetworkAvailable | 7 | 指定只有在可用的免費 (非計量) 網路連線時,背景工作才能執行。 |
InternetAvailable | 3 | 指定背景工作只能在網際網路可用時執行。 如果觸發了具有 InternetAvailable 條件的背景工作,且網際網路無法使用,工作將不會執行,直到網際網路再次可用為止。 這個條件可以節省電源,因為直到網路可用前,背景工作都不會執行。 這個條件不提供即時啟動。 重要 在背景工作上設定 IsNetworkRequested ,以確保網路在執行背景工作時保持運作。 這會告訴背景工作基礎結構在工作執行時保持網路狀態,即使裝置已進入連線待命模式,如此您就可以在連線待命模式中呼叫核心網路 API (HttpClient、 StreamSocket、 DatagramSocket等 ) 如果您的背景工作未設定 IsNetworkRequested,則您的背景工作將無法在連線待命模式中存取網路 (,例如, 當手機的畫面關閉時。) |
InternetNotAvailable | 4 | 指定背景工作只能在無法使用網際網路時執行。 如果觸發 了具有 InternetNotAvailable 條件的背景工作,且網際網路可供使用,工作將不會執行,直到網際網路無法使用為止。 |
Invalid | 0 | 不是有效的條件類型。 |
SessionConnected | 5 | 指定只有在使用者會話連線時,背景工作才能執行。 如果觸發了 具有 SessionConnected 條件的背景工作,而且使用者會話未登入,工作會在使用者登入時執行。 |
SessionDisconnected | 6 | 指定只有在使用者會話中斷連線時,背景工作才能執行。 如果觸發 了 SessionDisconnected 條件的背景工作,且使用者已登入,當使用者中斷遠端桌面會話連線或執行快速使用者切換 > 時,工作將會執行。注意]
|
UserNotPresent | 2 | 指定背景工作只能在使用者不存在時執行。 如果觸發 了 UserNotPresent 條件的背景工作,而且使用者存在,工作將不會執行,直到使用者變成非使用中為止。 |
UserPresent | 1 | 指定背景工作只能在使用者存在時執行。 如果觸發 了具有 UserPresent 條件的背景工作,而且使用者已離開,工作將不會執行,直到使用者存在為止。 |