This sample shows you how to launch the user's default app for file type or a protocol. You can also learn how to enable your app to be the default app for a file type or a protocol.
Note This sample was created using one of the universal app templates available in Visual Studio. It shows how its solution is structured so it can run on both Windows 8.1 and Windows Phone 8.1. For more info about how to build apps that target Windows and Windows Phone with Visual Studio, see Build apps that target Windows and Windows Phone 8.1 by using Visual Studio.
A Windows Runtime app can't set, change, or query the default apps for file types and protocols. The operating system asks the user to select which app to use as the default for each file type and protocol.
The sample covers these key tasks:
- launching the default app for a file using LaunchFileAsync
- handling file activation through the Activated event
- launching the default app for a protocol using LaunchUriAsync
- handling protocol activation through the Activated event
The sample covers this new task for Windows 8.1:
- launching a target app and having the currently running source app remain on the screen for various amounts of screen space using
Note LauncherOptions.DesiredRemainingView isn't supported for Windows Phone.
To obtain an evaluation copy of Windows 8.1, go to Windows 8.1.
To obtain an evaluation copy of Microsoft Visual Studio 2013 Update 2, go to Microsoft 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.
- Windows 8 app samples
- How to handle file activation (C#/VB/C++)
- How to handle protocol activation (C#/VB/C++)
- How to launch the default app for a file (C#/VB/C++)
- How to launch the default app for a protocol (C#/VB/C++)
- Guidelines and checklist for file types and protocols
Operating system requirements
Build the sample
- Start Visual Studio 2013 Update 2 and select File > Open > Project/Solution.
- Select either the Windows or Windows Phone project version of the sample. Press Ctrl+Shift+B, or select Build > Build Solution.
Run the sample
The next steps depend on whether you just want to deploy the sample or you want to both deploy and run it.
Deploying the sample
- Select either the Windows or Windows Phone project version of the sample.
- Select Build > Deploy Solution.
Deploying and running the sample
- Right-click either the Windows or Windows Phone project version of the sample in Solution Explorer and select Set as StartUp Project.
- 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.