Share via


Installation Address User Interface Dialog Box

You can use the Installation Address dialog box to enable the user to select the Web location where application files will be installed. The Virtual directory field corresponds to the VirtualDirectory properties set for the Web Application Folder in the File System Editor; the values entered into this field can be retrieved in a custom action using the [TARGETVDIR] property. This dialog box is available only for Web Setup projects.

The Installation Address dialog box should be the next-to-last dialog box in the Start section of the User Interface Editor, before the Confirm Installation dialog box. If this dialog box is preceded by one or more custom dialog boxes (CheckBoxes, RadioButtons, or TextBoxes), the Back button will be disabled; otherwise, it will be enabled.

The Application Pool list shows the available application pools on the target computer. The default setting for this option is the same as the default setting shown in the Application Pools folder in Internet Information Services in the Computer Management dialog box. (In Windows Explorer, right-click My Computer and click Manage.)

Note

You can set the application pool at a command prompt, or, more typically, from a batch file that runs the .msi installer. To do this, set the [TARGETAPPPOOL] property to an available application pool by using the msiexec command as follows:

msiexec /i MyWebSetup.msi /qn TARGETAPPPOOL="ASP.NET V2.0"

You can also set the installation address at a command prompt by using a command such as the following:

msiexec /i MyWebSetup.msi /qn TARGETSITE=/LM/W3Svc/2 TARGETVDIR=TestVDir

[TARGETSITE] is the metabase value for the Web site and [TARGETVDIR] is a folder in the Web site's root directory in which the Web application is to be installed. In this case, the target path is W3SVC/2/Root/TestVDir. You can use this command in custom actions to set other Internet Information Services (IIS) properties such as AnonymousAccess.

The following illustration shows a typical Installation Address dialog box, as it appears during installation.

Installation Address dialog box

Deployment UI splash screen

The only property available for the Installation Address dialog box is the BannerBitmap property, which sets the image that appears in the upper-right corner of the dialog box. The position and size of the image are fixed.

Tip

In order to create a consistent user interface, you should use the same image for all dialog boxes in an installer.

See Also

Concepts

Deployment and the Run-Time User Interface

Installation Dialog Box Restrictions

Reference

CustomActionData Property

VirtualDirectory Property

Other Resources

User Interface Management in Deployment

Deployment Dialog Boxes