How to: Install Prerequisites with a ClickOnce Application

Note

This article applies to Visual Studio 2015. If you're looking for Visual Studio 2017 documentation, use the version selector at the top left. We recommend upgrading to Visual Studio 2017. Download it here.

All ClickOnce applications require that the correct version of the .NET Framework is installed on a computer before they can be run; many applications have other prerequisites as well. When publishing a ClickOnce application, you can choose a set of prerequisite components to be packaged along with your application. At installation time, a check will be performed for each prerequisite to determine if it already exists; if not it will be installed prior to installing the ClickOnce application.

Instead of packaging and publishing prerequisites, you can also specify a download location for the components. For example, rather than including prerequisites with every application that you publish, you might use a centralized file share or Web location that contains the installers for all of your prerequisites—at install time, the components will be downloaded and installed from that location.

Important

You should add prerequisite installer packages to your development computer before you publish your first ClickOnce application. For more information, see How to: Include Prerequisites with a ClickOnce Application.

Prerequisites are managed in the Prerequisites dialog box, accessible from the Publish pane of the Project Designer.

Note

In addition to the predetermined list of prerequisites, you can add your own components to the list. For more information, see Creating Bootstrapper Packages.

To specify prerequisites to install with a ClickOnce application

  1. With a project selected in Solution Explorer, on the Project menu click Properties.

  2. Select the Publish pane.

  3. Click the Prerequisites button to open the Prerequisites dialog box.

  4. In the Prerequisites dialog box, make sure that the Create setup program to install prerequisite components check box is selected.

  5. In the Prerequisites list, check the components that you wish to install, and then click OK.

    The selected components will be packaged and published along with your application.

To specify a different download location for prerequisites

  1. With a project selected in Solution Explorer, on the Project menu click Properties.

  2. Select the Publish pane.

  3. Click the Prerequisites button to open the Prerequisites dialog box.

  4. In the Prerequisites dialog box, make sure that the Create setup program to install prerequisite components check box is selected.

  5. In the Specify the install location for prerequisites section, select Download prerequisites from the following location.

  6. Select a location from the drop-down list, or enter a URL, file path, or FTP location, and then click OK.

    Note

    You must make sure that installers for the specified components exist at the specified location.

See Also

Publishing ClickOnce Applications
How to: Publish a ClickOnce Application using the Publish Wizard