.NET/J# Tab for a Release

InstallShield 2016 » Releases View » Release

Project • The .NET/J# tab is available in the following project types:

•

Basic MSI

•

InstallScript MSI

The .NET/J# tab is where you add support for the 32-bit versions of the .NET Framework 1.0, 1.1, or 2.0. It is also where you add J# support to your project.

Note • To include other versions of the .NET Framework redistributables in your project, use the Redistributables view to add the appropriate InstallShield prerequisite for the Microsoft .NET Framework to your project.

For more information, see Adding .NET Framework Redistributables to Projects.

Settings on the .NET/J# Tab

Setting

Project Type

Description

.NET Framework Location

Basic MSI, InstallScript MSI

Specify where the .NET Framework runtime should be located. The .NET Framework is required for applications that are using any .NET features. Valid options are:

•

Copy From Source Media—Leave the .NET Framework runtime on the root of the source media. This option is not applicable to Web media types or Network Image media types with all of your files compressed into Setup.exe.

•

Extract From Setup.exe—Compress the .NET Framework runtime into Setup.exe, to be extracted at run time.

•

Download from the Web—Download the .NET Framework runtime (if necessary) from a URL that you specify. If you select this option, you must set the value of the .NET and J# Framework URL setting to the appropriate Web location.

•

Do Not Include—Do not include one of the 32-bit versions of the .NET Framework 1.0, 1.1, or 2.0 in the selected release.

.NET Framework Version

Basic MSI, InstallScript MSI

Select the 32-bit version of the .NET Framework that you want to distribute with your installation.

Note • To include .NET Framework 3.5, 3.0 SP1, 3.0, 2.0 SP1 (x86, x64, IA64), or 2.0 (only x64, IA64) redistributables in your project, use the Redistributables view to add the appropriate InstallShield prerequisite for the Microsoft .NET Framework to your project.

For more information, see Adding .NET Framework Redistributables to Projects.

.NET 1.1/2.0 Core Language

Basic MSI, InstallScript MSI

If you selected .NET version 1.1 for the .NET Framework Version setting, you can specify one .NET core language that you want to distribute. This is the language that is used while the .NET 1.1 core redistributable is installed. If you selected version 2.0, the language options are all selected and disabled since they are all included with this version of the redistributable.

To change the core language, click the ellipsis button (...) in this setting.

Command Line to Pass to Dotnetfx.exe

Basic MSI, InstallScript MSI

Note • This setting applies only if .NET 1.1 is selected for the .NET Framework Version setting.

Enter the command line that you want to pass to Microsoft's DotNetFx.exe.

.NET 1.1/2.0 Language Packs

Basic MSI, InstallScript MSI

To include .NET language packs, click the ellipsis button (...) in this setting. The options that are available depend on the Microsoft language packs that you have installed on your build machine. If you click the ellipsis button, you can download additional available language packs.

Command Line to Pass to Language Packs

Basic MSI, InstallScript MSI

Note • This setting applies only if .NET 1.1 is selected for the .NET Framework Version setting.

Enter the command line that you want to send to all of the Microsoft LangPack.exe files included with the installation.

Display .NET Option Dialog

Basic MSI, InstallScript MSI

Indicates whether Setup.exe displays a Yes/No message box asking the end user if they want to install .NET Framework on the target system. This setting does not determine whether your installation includes the .NET Framework, only whether the end user has a choice to install it.

•

No—Installs the .NET Framework, if required, without displaying a message box to the end user.

•

Yes—Displays the .NET option message box, which allows the end user to specify whether to install the .NET Framework.

If you select Yes, a message box is displayed on the target system at run time. The message box states that the installation optionally uses the Microsoft .NET Framework and asks if they would like to install it.

Show Full User Interface when Installing .NET Framework

Basic MSI, InstallScript MSI

Specify whether you want the full interface for the .NET Framework installation to be displayed.

If you select Yes, the Microsoft .NET Framework (English) Setup wizard appears when dotnetfx.exe installs the .NET Framework on the target system. This wizard shows the progress of the .NET Framework installation.

If you select No, the InstallShield Wizard appears when dotnetfx.exe installs the .NET Framework on the target system. This InstallShield Wizard shows the progress of the .NET Framework installation.

.NET Build Configuration

Basic MSI, InstallScript MSI

The .NET Build Configuration setting contains the name of the build configuration of the .NET solution. InstallShield uses this setting to determine the location of a project outputs’ files (for example, Debug or Release). The C# and VB.NET project wizards automatically update the value of this setting when you create a new project or change the solution for the project.

.NET and J# Framework URL

Basic MSI, InstallScript MSI

Specify the location from which your installation downloads the .NET Framework runtime and the J# redistributable, if included. It is not necessary to specify the file name in the URL.

This setting is required only if the .NET Framework Location or J# Redistributable Location setting (if included) for the current release is set to Download from the Web.

The installation downloads and runs the InstallShield file Dotnetfx.exe, which in turn downloads Dotnetredist.exe from the Microsoft Web site. This behavior is hard-coded in Dotnetfx.exe, which can be hosted anywhere.

J# Redistributable Location

Basic MSI, InstallScript MSI

Specify where the J# redistributable should be located. The .NET Framework is required for applications that use .NET features. Available options are:

•

Copy from Source Media—Leave the J# redistributable on the root of the source media. This option is not applicable to Web media types or Network Image media types with all of your files compressed into Setup.exe.

•

Extract from Setup.exe—Compress the J# redistributable into Setup.exe, to be extracted at run time.

•

Download from the Web—Download the J# redistributable (if necessary) from the URL specified in the .NET and J# Framework URL setting.

•

Do Not Include—Do not include the J# redistributable in the selected release.

Note • The J# version number that is used matches whatever version number that you select for the .NET Framework. You cannot install version 1.1 of one of these redistributables and version 2.0 of the other.

Command Line to Pass to the J# Redistributable

Basic MSI, InstallScript MSI

Specify a command-line parameter to pass to vjredist.exe. Consult Microsoft Support for valid command-line parameters.

Display J# Option Dialog

Basic MSI, InstallScript MSI

Specify whether the installation should display a dialog that lets end users indicate if they want to install J# on the target system.

Note • If the .NET Framework 1.1 is also included in the installation, the dialog states that .NET Framework 1.1 will also be installed.

Install J# if Installation Runs Silently

Basic MSI, InstallScript MSI

Specify whether you want to install J# on the target system if the J# Option dialog cannot be shown (for example, if the installation is run silently).

.NET/J# Tab for a Release

InstallShield 2016 Help Library

August 2016