This sample demonstrates how to update a pinned secondary tile in a Windows Phone Store app.

When using RequestCreateAsync to pin a secondary tile to the user's start screen, the app will be suspended. This is a different behavior from how this API works in an app running on a PC. Because of this behavior, any code called after RequestCreateAsync is not guaranteed to run before the app is suspended. To avoid this potential issue, you should update a pinned tile in the Suspending event of your app.

The sample demonstrates two scenarios. The first scenario shows the pattern that is not recommend, so that you can understand the issue. The second scenario shows the recommended pattern that updates the tile during the Suspending event.

Note  This sample requires Windows 8.1 and Microsoft Visual Studio 2013 with Update 2 or later.

To obtain an evaluation copy of Windows 8.1, go to Windows 8.1.

To obtain an evaluation copy of Visual Studio 2013 , go to Visual Studio 2013 . After you install Visual Studio 2013, update your installation with Update 2 or later.

Operating system requirements

Build the sample

1. Start Visual Studio Express 2013 for Windows --> and select File > Open > Project/Solution.
2. Go to the directory in which you unzipped the sample. Go to the directory named for the sample, and double-click the Visual Studio Express 2013 for Windows Solution (.sln) file.
3. Press F7 or use Build > Build Solution to build the sample.

Run the sample

To debug the app and then run it, press F5 or use Debug > Start Debugging. To run the app without debugging, press Ctrl+F5 or use Debug > Start Without Debugging.