Enables an app to schedule background tasks to run app code even when the app is suspended.
Background tasks are intended for small work items that do not require user interaction. Scenarios that are appropriate for background tasks include downloading mail, showing a toast notification for an incoming chat message, or reacting to a change in a system condition.
See Supporting your app with background tasks (Windows Store apps using JavaScript and HTML) or Supporting your app with background tasks (Windows Store apps using C#/VB/C++ and XAML) for guidance on implementing background tasks. For a general overview of background tasks in Windows Store apps, see the Introduction to Background Tasks whitepaper. For example code that shows how to implement background tasks, see the Background Task Sample.
Members
The Windows.ApplicationModel.Background namespace has these types of members:
Classes
The Windows.ApplicationModel.Background namespace has these classes.
| Class | Description |
|---|---|
| BackgroundExecutionManager | Provides methods that let an app ask to be added to the lock screen's apps list or query its current access to background activity and badge updates on the lock screen. |
| BackgroundTaskBuilder | Represents a background task to be registered with the system. |
| BackgroundTaskCompletedEventArgs | Represents completion information for a task at the time a completion notification is sent. |
| BackgroundTaskDeferral | Represents a background task deferral returned by the IBackgroundTaskInstance.GetDeferral method. |
| BackgroundTaskProgressEventArgs | Represents progress information for a task at the time a progress update notification is sent. |
| BackgroundTaskRegistration | Represents a background task that has been registered with the system. |
| MaintenanceTrigger | Represents a maintenance trigger. |
| NetworkOperatorHotspotAuthenticationTrigger | Represents a mobile network operator hotspot authentication trigger. |
| NetworkOperatorNotificationTrigger | Represents a mobile network operator notification trigger. |
| PushNotificationTrigger | Represents an object that invokes a background work item on the app in response to the receipt of a raw notification. |
| SystemCondition | Represents a system condition that must be in effect for a background task to run. |
| SystemTrigger | Represents a system event that triggers a background task to run. |
| TimeTrigger | Represents a time event that triggers a background task to run. |
Delegates
The Windows.ApplicationModel.Background namespace has these delegates.
| Delegate | Description |
|---|---|
| BackgroundTaskCanceledEventHandler | Represents a method that handles the cancellation of a background task. |
| BackgroundTaskCompletedEventHandler | Represents a method that handles completion events for a background task. |
| BackgroundTaskProgressEventHandler | Represents a method that handles progress update events for a background task. |
Enumerations
The Windows.ApplicationModel.Background namespace has these enumerations.
| Enumeration | Description |
|---|---|
| BackgroundAccessStatus | Specifies an app's ability to perform background activity and display a tile on the lock screen. |
| BackgroundTaskCancellationReason | Specifies the reasons for cancelling a background task. |
| SystemConditionType | Specifies a system condition that must be in effect for a background task to run. If a background task with a system condition is triggered, the task will not run until the condition is met. |
| SystemTriggerType | Specifies the system events that can be used to trigger a background task. |
Interfaces
The Windows.ApplicationModel.Background namespace defines these interfaces.
| Interface | Description |
|---|---|
| IBackgroundCondition | Used to enforce the system condition object type. |
| IBackgroundTask | Provides a method to perform the work of a background task. |
| IBackgroundTaskInstance | Provides access to a background task instance. |
| IBackgroundTaskRegistration | Provides access to a registered background task. |
| IBackgroundTrigger | Represents the base interface for trigger events. |
Requirements
|
Minimum supported client | Windows 8 |
|---|---|
|
Minimum supported server | Windows Server 2012 |
|
Namespace |
|
|
Metadata |
|
See also
Build date: 12/4/2012
