Freigeben über


SystemConditionType Enumeration

Definition

Gibt eine Systembedingung an, die wirksam sein muss, damit eine Hintergrundaufgabe ausgeführt werden kann. Wenn eine Hintergrundaufgabe mit einer Systembedingung ausgelöst wird, wird die Aufgabe erst ausgeführt, wenn die Bedingung erfüllt ist.

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
Vererbung
SystemConditionType
Attribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Felder

BackgroundWorkCostNotHigh 8

Gibt an, dass die Hintergrundaufgabe nur ausgeführt werden kann, wenn die Kosten für hintergrundarbeiten niedrig sind.

FreeNetworkAvailable 7

Gibt an, dass die Hintergrundaufgabe nur ausgeführt werden kann, wenn eine freie (nicht getaktete) Netzwerkverbindung verfügbar ist.

InternetAvailable 3

Gibt an, dass die Hintergrundaufgabe nur ausgeführt werden kann, wenn das Internet verfügbar ist. Wenn eine Hintergrundaufgabe mit der Bedingung InternetAvailable ausgelöst wird und das Internet nicht verfügbar ist, wird die Aufgabe erst ausgeführt, wenn das Internet wieder verfügbar ist. Diese Bedingung spart Energie, da die Hintergrundaufgabe erst ausgeführt wird, wenn das Netzwerk verfügbar ist. Dieser Zustand stellt keine Aktivierung in Echtzeit bereit.

Wichtig

Legen Sie IsNetworkRequested für Ihre Hintergrundaufgabe fest, um sicherzustellen, dass das Netzwerk aktiv bleibt, während die Hintergrundaufgabe ausgeführt wird. Dies weist die Hintergrundaufgabeninfrastruktur an, das Netzwerk während der Ausführung der Aufgabe aufrecht zu halten, auch wenn das Gerät in den Modus "Verbundener Standby" gewechselt ist, sodass Sie die Kernnetzwerk-APIs (HttpClient, StreamSocket, DatagramSocket usw.) aufrufen können. Wenn Ihre Hintergrundaufgabe IsNetworkRequested nicht festgelegt hat, kann Ihre Hintergrundaufgabe nicht auf das Netzwerk zugreifen, wenn sie sich im Modus "Verbundener Standbymodus" befindet (z. B. wenn der Bildschirm eines Telefons ausgeschaltet ist).

InternetNotAvailable 4

Gibt an, dass die Hintergrundaufgabe nur ausgeführt werden kann, wenn das Internet nicht verfügbar ist. Wenn eine Hintergrundaufgabe mit der Bedingung InternetNotAvailable ausgelöst wird und das Internet verfügbar ist, wird die Aufgabe erst ausgeführt, wenn das Internet nicht verfügbar ist.

Invalid 0

Kein gültiger Bedingungstyp.

SessionConnected 5

Gibt an, dass die Hintergrundaufgabe nur ausgeführt werden kann, wenn die Sitzung des Benutzers verbunden ist. Wenn eine Hintergrundaufgabe mit der SessionConnected-Bedingung ausgelöst wird und die Benutzersitzung nicht angemeldet ist, wird die Aufgabe ausgeführt, wenn sich der Benutzer anmeldet.

SessionDisconnected 6

Gibt an, dass die Hintergrundaufgabe nur ausgeführt werden kann, wenn die Sitzung des Benutzers getrennt wird. Wenn eine Hintergrundaufgabe mit der SessionDisconnected-Bedingung ausgelöst wird und der Benutzer angemeldet ist, wird die Aufgabe ausgeführt, wenn der Benutzer die Remotedesktopsitzung trennt oder einen schnellen Benutzerwechsel> durchführt [! HINWEIS]

SessionDisconnected wird hauptsächlich im Kontext von Remotedesktops und schnellem Benutzerwechsel verwendet. Sie soll nicht als Benachrichtigung verwendet werden, dass sich der Benutzer vom Computer abgemeldet hat.

UserNotPresent 2

Gibt an, dass die Hintergrundaufgabe nur ausgeführt werden kann, wenn der Benutzer nicht anwesend ist. Wenn eine Hintergrundaufgabe mit der UserNotPresent-Bedingung ausgelöst wird und der Benutzer anwesend ist, wird die Aufgabe erst ausgeführt, wenn der Benutzer inaktiv wird.

UserPresent 1

Gibt an, dass die Hintergrundaufgabe nur ausgeführt werden kann, wenn der Benutzer anwesend ist. Wenn eine Hintergrundaufgabe mit der UserPresent-Bedingung ausgelöst wird und der Benutzer abwesend ist, wird die Aufgabe erst ausgeführt, wenn der Benutzer anwesend ist.

Gilt für:

Weitere Informationen