Export (0) Print
Expand All
3 out of 14 rated this helpful - Rate this topic

How to: Specify Which Files Are Published via ClickOnce 

When publishing a ClickOnce application, all non-code files in the project are deployed along with the application. In some cases, you may not want or need to publish certain files, or you may want to install certain files based on conditions. Visual Studio provides the capabilities to exclude files, mark files as data files or prerequisites, and create groups of files for conditional installation.

Files for a ClickOnce application are managed in the Application Files dialog box, accessible from the Publish page of the Project Designer.

Initially, there is a single file group named (Required). You can create additional file groups and assign files to them. You cannot change the Download Group for files that are required for the application to run. For example, the application's .exe or files marked as data files must belong to the (Required) group.

The default publish status value of a file is tagged with (Auto). For example, the application's .exe has a publish status of Include (Auto) by default.

Files with the Build Action property set to Content are designated as application files and will be marked as included by default; they can be included, excluded, or marked as data files. The exceptions are:

  • Data files such as SQL Database (.mdf and .mdb) files and XML files will be marked as data files by default.

  • References to assemblies (.dll files) are designated as follows when you add the reference: If Copy Local is False, it is marked by default as a prerequisite assembly (Prerequisite (Auto)) that must be present in the GAC before the application is installed. If Copy Local is True, the assembly is marked by default as an application assembly (Include (Auto)) and will be copied into the application folder at installation. A COM reference will only appear in the Application Files dialog box (as an .ocx file) if its Isolated property is set to True, and it will be included by default.

To exclude files from ClickOnce publishing

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

  2. Click the Publish tab.

  3. Click the Application Files button to open the Application Files dialog box.

  4. In the Application Files dialog box, select the file that you wish to exclude.

  5. In the Publish Status field, select Exclude from the drop-down list.

To mark files as data files

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

  2. Click the Publish tab.

  3. Click the Application Files button to open the Application Files dialog box.

  4. In the Application Files dialog box, select the file that you wish to mark as data.

  5. In the Publish Status field, select Data File from the drop-down list.

To mark files as prerequisites

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

  2. Click the Publish tab.

  3. Click the Application Files button to open the Application Files dialog box.

  4. In the Application Files dialog box, select the application assembly (.dll file) that you wish to mark as a prerequisite. Note that your application must have a reference to the application assembly in order for it to appear in the list.

  5. In the Publish Status field, select Prerequisite from the drop-down list.

To add a new file group

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

  2. Click the Publish tab.

  3. Click the Application Files button to open the Application Files dialog box.

  4. In the Application Files dialog box, select the Group field for a file that you wish to include in the new group.

  5. In the Download Group field, select <New...> from the drop-down list.

  6. In the New Group dialog box, enter a name for the group, and then click OK.

To add a file to a group

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

  2. Click the Publish tab.

  3. Click the Application Files button to open the Application Files dialog box.

  4. In the Application Files dialog box, select the Group field for a file that you wish to include in the new group.

  5. In the Download Group field, select a group from the drop-down list.

    NoteNote

    You cannot change the Download Group for files that are required for the application to run.

See Also

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.