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, and the default setting is named DefaultAppPool. To change the default application pool in your Web setup projects, you can use a post-build action to update the name of the application pool in the MSI. Alternatively, you can use Orca.exe to change the default name to look for an application pool with a different name.
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
.gif "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
Reference
Concepts
Installation Dialog Box Restrictions