Background task sample
Shows how to create and register background tasks using the Windows Runtime background task API.
Note: This sample is part of a large collection of UWP feature samples. If you are unfamiliar with Git and GitHub, you can download the entire collection as a ZIP file, but be sure to unzip everything to access shared dependencies. For more info on working with the ZIP file, the samples collection, and GitHub, see Get the UWP samples from GitHub. For more samples, see the Samples portal on the Windows Dev Center.
A background task is triggered by a system or time event and can be constrained by one or more conditions. When a background task is triggered, its associated handler runs and performs the work of the background task. A background task can run even when the app that registered the background task is suspended.
This sample demonstrates the following:
- Creating a background task that is triggered by a system event.
- Requesting the user's permission to add the app to the lock screen.
- Creating a background task that is triggered by a time trigger.
- Adding a condition that constrains the background task to run only when the condition is in effect.
- Creating and signaling an application trigger.
- Reporting background task progress and completion to the app.
- Using a deferral object to include asynchronous code in your background task.
- Handling the cancellation of a background task, and ensuring the task is cancelled when required conditions are no longer met.
- Initializing background task progress and completion handlers when the app is launched.
- Registering a background task in a Background Task Registration Group.
To obtain an evaluation copy of Windows 8.1, go to Windows 8.1.
To obtain an evaluation copy of Microsoft Visual Studio 2013, go to Visual Studio 2013.
Note For Windows 8 app samples, download the Windows 8 app samples pack. The samples in the Windows 8 app samples pack will build and run only on Microsoft Visual Studio 2012.
Operating system requirements
Windows Phone 10
Build the sample
- If you download the samples ZIP, be sure to unzip the entire archive, not just the folder with the sample you want to build.
- Start Microsoft Visual Studio 2017 and select File > Open > Project/Solution.
- Press Ctrl+Shift+B, or select Build > Build Solution.
Run the sample
Deploying the sample
- Select Build > Deploy Solution.
Deploying and running the sample
- To debug the sample and then run it, press F5 or select Debug > Start Debugging. To run the sample without debugging, press Ctrl+F5 or selectDebug > Start Without Debugging.
Triggering background tasks
To trigger the background tasks associated with the TimeZoneChange event:
- Change date and time settings.
- Click Change time zone...
- Select a time zone that has a UTC offset different from the currently selected time zone.
- Click OK.
Background tasks associated with the TimeTrigger event will only fire if the app is currently on the lock screen. There are two ways to accomplish this.
Accept the initial request to add the BackgroundTaskSample app to the lock screen:
- Launch the BackgroundTaskSample app for the first time.
- Register the TimeTrigger event.
- Accept the request to add the BackgroundTaskSample app to the lock screen.
Add the BackgroundTaskSample app to the lock screen manually:
- From the Start screen, go to Settings > Customize your lock screen.
- Choose the BackgroundTaskSample app for the lock screen.
- Launch the BackgroundTaskSample app and register the TimeTrigger event.
Note The minimum delay for creating TimeTrigger events is 15 minutes. The first timer event, however, might not occur until 15 minutes after it is expected to expire (30 minutes after the app registers the event).
See the following topics for step-by-step information about using background tasks:
- Create and register a background task
- Respond to system events with background tasks
- Set conditions for running a background task
- Handle a cancelled background task
- Monitor background task progress and completion
- Run a background task on a timer
- Use a maintenance trigger
- Declare background tasks in the application manifest
- Guidelines for background tasks
- Debug a background task