SystemTriggerType SystemTriggerType SystemTriggerType SystemTriggerType Enum

Specifies the system events that can be used to trigger a background task.

Syntax

Declaration

public enum SystemTriggerTypepublic enum SystemTriggerTypePublic Enum SystemTriggerType

Fields

BackgroundWorkCostChange
BackgroundWorkCostChange
BackgroundWorkCostChange
BackgroundWorkCostChange

The background task is triggered when the cost of background work changes.

Windows 8Windows Server 2012Windows 8.1Windows Server 2012 R2Windows Phone 8.1 An app must be placed on the lock screen before it can successfully register background tasks using this trigger type.

Windows 10Windows Server 2016Windows 10 Mobile You do not need to place an app on the lock screen before the app can successfully register background tasks using this trigger type.

ControlChannelReset
ControlChannelReset
ControlChannelReset
ControlChannelReset

The background task is triggered when a control channel is reset.

Note

This trigger type does not support a OneShot mode. So the OneShot parameter must be false when using the @Windows.ApplicationModel.Background.SystemTrigger.#ctor(Windows.ApplicationModel.Background.SystemTriggerType,System.Boolean) constructor.

Windows 8Windows Server 2012Windows 8.1Windows Server 2012 R2Windows Phone 8.1 An app must be placed on the lock screen before it can successfully register background tasks using this trigger type.

Windows 10Windows Server 2016Windows 10 Mobile You do not need to place an app on the lock screen before the app can successfully register background tasks using this trigger type.

DefaultSignInAccountChange
DefaultSignInAccountChange
DefaultSignInAccountChange
DefaultSignInAccountChange

The background task is triggered when the default sign-in account changes.

Note

This value was introduced in Windows 10, version 1607.

InternetAvailable
InternetAvailable
InternetAvailable
InternetAvailable

The background task is triggered when the Internet becomes available.

Invalid
Invalid
Invalid
Invalid

Not a valid trigger type.

LockScreenApplicationAdded
LockScreenApplicationAdded
LockScreenApplicationAdded
LockScreenApplicationAdded

The background task is triggered when a tile is added to the lock screen.

LockScreenApplicationRemoved
LockScreenApplicationRemoved
LockScreenApplicationRemoved
LockScreenApplicationRemoved

The background task is triggered when a tile is removed from the lock screen.

NetworkStateChange
NetworkStateChange
NetworkStateChange
NetworkStateChange

The background task is triggered when a network change occurs, such as a change in cost or connectivity.

OnlineIdConnectedStateChange
OnlineIdConnectedStateChange
OnlineIdConnectedStateChange
OnlineIdConnectedStateChange

The background task is triggered when the Microsoft account connected to the account changes.

PowerStateChange
PowerStateChange
PowerStateChange
PowerStateChange

The background task is triggered when the status of the battery, BatteryStatus, changes.

Note

This value was introduced in Windows 10.

ServicingComplete
ServicingComplete
ServicingComplete
ServicingComplete

The background task is triggered when the system has finished updating an app.

SessionConnected
SessionConnected
SessionConnected
SessionConnected

The background task is triggered when the session is connected.

Windows 8Windows Server 2012Windows 8.1Windows Server 2012 R2Windows Phone 8.1 An app must be placed on the lock screen before it can successfully register background tasks using this trigger type.

Windows 10Windows Server 2016Windows 10 Mobile You do not need to place an app on the lock screen before the app can successfully register background tasks using this trigger type.

SmsReceived
SmsReceived
SmsReceived
SmsReceived

The background task is triggered when a new SMS message is received by an installed mobile broadband device.

TimeZoneChange
TimeZoneChange
TimeZoneChange
TimeZoneChange

The background task is triggered when the time zone changes on the device (for example, when the system adjusts the clock for daylight saving time).

Note

This trigger only fires if the new time zone actually changes the system time.

UserAway
UserAway
UserAway
UserAway

The background task is triggered when the user becomes absent.

Windows 8Windows Server 2012Windows 8.1Windows Server 2012 R2Windows Phone 8.1 An app must be placed on the lock screen before it can successfully register background tasks using this trigger type.

Windows 10Windows Server 2016Windows 10 Mobile You do not need to place an app on the lock screen before the app can successfully register background tasks using this trigger type.

UserPresent
UserPresent
UserPresent
UserPresent

The background task is triggered when the user becomes present.

Windows 8Windows Server 2012Windows 8.1Windows Server 2012 R2Windows Phone 8.1 An app must be placed on the lock screen before it can successfully register background tasks using this trigger type.

Windows 10Windows Server 2016Windows 10 Mobile You do not need to place an app on the lock screen before the app can successfully register background tasks using this trigger type.

Device family

Windows 10 (introduced v10.0.10240.0)

API contract

Windows.Foundation.UniversalApiContract (introduced v1)

Attributes

Windows.Foundation.Metadata.ContractVersionAttribute

Details

Assembly

Windows.ApplicationModel.Background.dll