Publish Options Dialog Box

The Publish Options dialog box specifies an application's deployment options.

To access this dialog box, click a project node in Solution Explorer, and then, on the Project menu, click Properties. When the Project Designer appears, click the Publish tab. On the Publish page, click the Options button.

The Publish Options dialog box is categorized into four separate sections that are accessed through a new navigation pane.

The following sections describe the new UI configuration.

Description

To access the Description options, click Description in the Publish Options dialog box.

  • Publish language
    Specifies the language and locale in which the application is to be published.

  • Publisher name
    Specifies the name of the application's publisher (optional). If this box is empty, the value of the computer's RegisteredOrganization property is used. If that value is null, the project name is used.

  • Suite name
    Specifies the name of the folder on the Start menu in which the application will be installed.

  • Product name
    Specifies the product name of the application (optional). If the product name is blank, the assembly name is used.

  • Support URL
    Specifies a Web site that contains support information for your application. Specifying this URL is optional. If used, this URL appears in the Add or Remove Programs entry for your application in the Windows Control Panel.

  • Error URL
    Specifies a Web site that will be displayed in dialog boxes that are encountered during ClickOnce installations. For more information, see <customErrorReporting> Element (ClickOnce Deployment).

Deployment

To access the Deployment options, click Deployment in the Publish Options dialog box.

  • Deployment web page
    Specifies a name for the deployment Web page. The default file name is Publish.htm.

  • Automatically generate deployment web page after every publish
    When this check box is selected (the default), the publish process will generate a deployment Web page.

    This option is available only if a Deployment web page is specified.

  • Open deployment web page after publish
    When this check box is selected (the default), the automatically generated deployment Web page opens upon publishing.

  • Use ".deploy" file extension
    When this check box is selected (the default), the deployment file has the extension .deploy. For more information about why this extension should be used, see "Windows Server: Locked-Down Content Types " in Server and Client Configuration Issues in ClickOnce Deployments.

  • For CD installations, automatically start Setup when CD is inserted
    By default, this option is cleared. Selecting this option generates an autorun.inf file at the root level of the installation CD-ROM or DVD-ROM; the autorun file automatically starts the installation when a user inserts the CD-ROM or DVD-ROM in a computer.

  • Verify files uploaded to a web server
    When this check box is selected (the default), the publish process downloads each file to verify that each file can be downloaded. You are notified about files that cannot be downloaded.

Manifests

To access the Manifests options, click Manifests in the Publish Options dialog box.

  • Block application from being activated via a URL
    When this check box is cleared (the default), the application runs automatically after installation. Selecting this check box specifies that the end user can start the application only from the Start menu; this blocks the application from being started by using a URL. For more information, see DisallowUrlActivation.

  • Allow URL parameters to be passed to application
    By default, this option is cleared. Selecting this check box sets trustURLParameters to true in the deployment manifest; this enables the application to access and process URL parameter information. Your application will also have to call ActivationUri to retrieve the URL used to start the deployment manifest of the application. For information about how to do this, see How to: Retrieve Query String Information in an Online ClickOnce Application.

  • Use application manifest for trust information
    When selected, this option enables you to re-sign the application manifest (using a certificate) with your own Publisher name, Product name, and Support URL (that is, your own company name and application name). The publisher, product, and support URL information appears on the Do you want to trust this application? dialog box at installation. By default, this check box is cleared, and the deployment uses the Microsoft certificate information.

  • Exclude deployment provider URL
    Specifies whether to exclude the deployment provider URL from the deployment manifest. Starting in Visual Studio 2008 SP1, the deployment provider URL can be excluded from the manifest for scenarios in which application updates should come from a location unknown at the time of the initial publication. After the application is published, updates will be checked from wherever the application is installed from.

  • Create desktop shortcut
    Specifies whether to create an icon on the desktop during installation. The shortcut is created for offline applications only.

File Associations

To access the File Associations options, click File Associations in the Publish Options dialog box.

  • Extension
    Specifies the file name extension to be associated with the application.

  • Description
    A description of the file type.

  • ProgID
    A name that uniquely identifies the file type.

  • Icon
    Specifies the icon to use for files that have this extension.

See Also

Reference

Publish Page, Project Designer