InstallUrl Property

Specifies a location where the user can download files if a launch condition evaluates to false. If this property contains a value, the user is presented with a dialog box containing Yes and No buttons, plus the message specified in the Message property.

If the user selects Yes, he will be redirected to the location specified in the property; in either case the installation will be terminated immediately.

Settings

The settings for the InstallUrl property are as follows:

Setting Description
Blank The dialog box will not be displayed; the standard Windows Installer termination dialog box will be shown instead.
URL Uses the format https://server/path/ where server and path define a valid Internet or intranet Web page.
Note   If the URL is invalid, the user does not have a Web connection, or the user does not have a Web browser installed, this will fail.
UNC path Uses the format \\server\share where server and share define a valid network file share.
Note   The user must have access permissions for the file share.
File path The path to the location of the file, relative to the location of the installer; for example, \My Application\MyFile.exe. Primarily used when deploying on redistributable media such as a CD-ROM.

Security Note   If the Bootstrapper property for the deployment project is set to Web Bootstrapper, you should only specify a URL. Specifying a UNC path or file path may allow files to be downloaded without any security prompt, creating a security risk for users. For more information, see Build, Configuration Properties, Deployment Project Properties Dialog Box.

Remarks

The .NET Framework Launch Condition sets the InstallUrl property to https://support.microsoft.com/support/vstudio/vsdeployment.asp, a Microsoft Support Web page that contains a downloadable installer for the .NET Framework. For all other launch conditions, the InstallUrl property is blank by default.

Note   If your application requires a different version of the .NET Framework, you will need to override the InstallUrl property and provide your own location. For more information, see .NET Framework Launch Condition. In addition, if you change the InstallUrl property, you should also change the Message property to a more appropriate message. For more information, see Message Property.

See Also

Deployment of .NET Framework Applications | .NET Framework Launch Condition | Launch Condition Management in Deployment