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

バックグラウンド タスクは、インターネットが使用可能なときにのみ実行できることを指定します。 InternetAvailable 条件を持つバックグラウンド タスクがトリガーされ、インターネットが使用できない場合、インターネットが再び使用可能になるまでタスクは実行されません。 この条件では、ネットワークが利用可能になるまでバックグラウンド タスクが実行されないため、電力が節約されます。 この条件では、リアルタイムのアクティブ化は行われません。

重要

バックグラウンド タスクの実行中にネットワークが稼働し続けられるように、バックグラウンド タスクに IsNetworkRequested を設定します。 これにより、デバイスがコネクト スタンバイ モードになった場合でも、タスクの実行中にネットワークを維持するようにバックグラウンド タスク インフラストラクチャに指示されます。これにより、コア ネットワーク API (HttpClient、 StreamSocket、 DatagramSocket など) を呼び出すことができます。バックグラウンド タスクで IsNetworkRequested が設定されていない場合、バックグラウンド タスクはコネクト スタンバイ モード (電話の画面がオフになっている場合など) にネットワークにアクセスできなくなります。
InternetNotAvailable 4

バックグラウンド タスクは、インターネットが使用できない場合にのみ実行できることを指定します。 InternetNotAvailable 条件を持つバックグラウンド タスクがトリガーされ、インターネットが使用可能な場合、インターネットが使用できないまでタスクは実行されません。
Invalid 0

有効な条件の種類ではありません。
SessionConnected 5

ユーザーのセッションが接続されている場合にのみバックグラウンド タスクを実行できることを指定します。 SessionConnected 条件を持つバックグラウンド タスクがトリガーされ、ユーザー セッションがログインしていない場合、ユーザーのログイン時にタスクが実行されます。
SessionDisconnected 6

ユーザーのセッションが切断されたときにのみバックグラウンド タスクを実行できることを指定します。 SessionDisconnected 条件を持つバックグラウンド タスクがトリガーされ、ユーザーがログインしている場合、ユーザーがリモート デスクトップ セッションを切断したとき、または高速なユーザー切り替えを>行うときにタスクが実行されます [!注]

SessionDisconnected は、主にリモート デスクトップと高速ユーザー切り替えのコンテキストで使用されます。 これは、ユーザーがコンピューターからログオフしたことを示す通知として使用されるものではありません。
UserNotPresent 2

ユーザーが存在しない場合にのみバックグラウンド タスクを実行できることを指定します。 UserNotPresent 条件を持つバックグラウンド タスクがトリガーされ、ユーザーが存在する場合、ユーザーが非アクティブになるまでタスクは実行されません。
UserPresent 1

ユーザーが存在する場合にのみバックグラウンド タスクを実行できることを指定します。 UserPresent 条件を持つバックグラウンド タスクがトリガーされ、ユーザーが不在の場合、ユーザーが存在するまでタスクは実行されません。

適用対象

こちらもご覧ください