Product Information Tab (Project Properties Dialog Box)

  • Article

   

Use this dialog box to set or change basic properties about the installed product in the end user's machine. Product information properties you can set or change here include the product name, version number, product or upgrade Globally Unique Identifier (GUID), manufacturer name, and customer support contact information.

You reach this dialog box in two steps:

  1. Select your installer project in the Project Explorer window.

  2. From the end of the Project menu, select the InstallerProjectNameProperties option.

Options

Default information is shown in the required fields. If no default is shown, the information is optional.

Name

Set the application title here. This title appears in the end user's Add/Remove Programs dialog box. The default is the Project Nameshown.

Product code

Use this field to establish the unique product code for the installed product. A unique system-generated Globally Unique Identifier (GUID) is shown. You can do one of the following:

  • Accept the default GUID as the product code.

  • Edit the product code by manually entering a new or different one.

  • Change the product code with the associated New code button.

New code

Select this button to change the system-generated product code. Each time you click New code, Microsoft® Visual Studio® Installer incrementally increases the GUID.

Upgrade code

Use this field to establish the unique code assigned to all updates of this product. For example, suppose your installer package file is the first version (1.0) of your product named MyProduct, which has the product code {99} and the update code {14}.

Once upgrade code {14} has been assigned to MyProduct, you should use it for any upgrades to the product. For example, if you ship version 2.0 of MyProduct, you would give it a new product code (maybe {191}) and the same upgrade code ({14}).

Assigning the same upgrade code to all product versions this way gives the Microsoft® Windows® installer the information it requires to automatically uninstall an older version of a product when a new version is installed.

Note   This feature is not available in version 1.0 of the Windows installer.

A unique system-generated Globally Unique Identifier (GUID) is shown as the default upgrade code. You can do one of the following:

  • Accept the default GUID as the upgrade code.

  • Edit the upgrade code by manually entering a new or different one.

  • Change the upgrade code with the associated New code button.

New code

Select this button to change the system-generated upgrade code. Each time you click New code, Visual Studio Installer incrementally increases the GUID.

Module signature

A unique name identifying the merge module. You can use a GUID or a more intelligible alphanumeric string — for example, MyCtrl.ListBox.

Version

Set the installed product's version number here. The default is version 1.0.0.0.

Apply

Accept the product information properties shown, and do not close the Project Properties dialog box.