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:

The sample covers this new task for Windows 8.1:

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.

Related topics

Windows 8 app samples
Tasks
How to handle file activation (JavaScript)
How to handle file activation (C#/VB/C++)
How to handle protocol activation (JavaScript)
How to handle protocol activation (C#/VB/C++)
How to launch the default app for a file (JavaScript)
How to launch the default app for a file (C#/VB/C++)
How to launch the default app for a protocol (JavaScript)
How to launch the default app for a protocol (C#/VB/C++)
Guidelines
Guidelines and checklist for file types and protocols
Reference
Windows.ApplicationModel.Activation.FileActivatedEventArgs
Windows.ApplicationModel.Activation.ProtocolActivatedEventArgs
Windows.System.Launcher.LaunchFileAsync
Windows.System.Launcher.LaunchUriAsync
Windows.UI.WebUI.WebUIFileActivatedEventArgs
Windows.UI.WebUI.WebUIProtocolActivatedEventArgs

Operating system requirements

Client
Windows 8.1
Server
Windows Server 2012 R2
Phone
Windows Phone 8.1

Build the sample

  1. Start Visual Studio 2013 Update 2 and select File > Open > Project/Solution.
  2. Go to the directory to which you unzipped the sample. Then go to the subdirectory containing the sample in the language you desire - either C++, C#, or JavaScript. Double-click the Visual Studio 2013 Update 2 Solution (.sln) file.
  3. 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

  1. Select either the Windows or Windows Phone project version of the sample.
  2. Select Build > Deploy Solution.

Deploying and running the sample

  1. Right-click either the Windows or Windows Phone project version of the sample in Solution Explorer and select Set as StartUp Project.
  2. 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.