This documentation is archived and is not being maintained.

Message Property (Launch Conditions)

Specifies a message to be displayed to the user when a launch condition evaluates to false at installation time. This message can be customized for your particular situation; for example, presenting a message informing the user where to obtain a missing component.

The settings for the Message property are as follows:



<Error Message>

Placeholder; replace this with your own error message.


Default message for the .NET Framework launch condition: "This setup requires the .NET Framework version VersionNumber. Please install the .NET Framework and run this setup again. The .NET Framework can be obtained from the Web. Would you like to do this now?" VersionNumber is the first version listed in the SupportedRuntimes property.


Default message for the Internet Information Services (IIS) launch condition: "This setup requires Internet Information Server 4.0 or later and Window NT 4.0, Windows 2000, or Windows XP. This setup cannot be installed on Windows 95, Windows 98, or Windows Me. Please install Internet Information Server and run this setup again."

For most launch conditions, the default for the Message property defaults to the placeholder "<Error Message>". You need to provide your own message text to prevent the placeholder from being displayed to the user.


If you use the InstallUrl property to redirect the user, you should be aware that the dialog box displayed will contain Yes and No buttons. In this case your message should be in the form of a question — for example, "MyComponent is required for this application. Would you like to install it now?" For more information, see InstallUrl Property (Launch Conditions).

For .NET Framework launch conditions, the default message assumes that you are using the default InstallUrl property to redirect the user to a Web site; you will need to provide a new message in the Message property if this is not the case. If the InstallUrl property is blank, a single button dialog box will be displayed with the text "This setup requires the .NET Framework version VersionNumber. Please install the .NET Framework and run this setup again."

If you have set the Localization property for your Setup project, any default message text will be automatically translated; you will need to translate any custom text yourself. For more information, see Localization Property.