Running Multiple Versions of Microsoft .NET Framework

In order for an ASP.NET application to run correctly under Microsoft IIS, the following must be installed and set up correctly.

  1. The correct version of ASP.NET must be registered / installed with IIS.

  2. The IIS scriptmap for the application must be set to the correct version of ASP.NET.  For example, an application built for .NET framework version 1.1 must have a scriptmap that specifies to use the 1.1 version of ASP.NET.

  3. The ASP.NET client script files (.js files) must be installed under the web server root directory.

Step 1:  To register version 1.1 of Microsoft .NET Framework 1.1, start the Command Prompt (MS-DOS) from the Windows Start menu, select Run and type Cmd to open the Command Prompt.

Go to the following directory:

C:\>  CD  \WINDOWS\Microsoft.NET\Framework\v1.1.4322

(your Windows directory may be different - such as WinXP).

Step 2:  Register ASP.NET with IIS without updating scriptmaps:

C:\>  aspnet_regiis -ir

Using the “-ir” option is safer if another version of ASP.NET is registered.  This option will not affect any current scriptmap configurations.

Check the current scriptmap configuration (i.e list keys):

C:\> aspnet_regiis -lk

 

W3SVC/  1.1.4322.0

W3SVC/1/ROOT/MyApp1/    1.1.4322.0

W3SVC/1/ROOT/MyApp2/    2.0.40607.0

The version of ASP.NET that owns the root scriptmap configuration is the one with “W3SVC/”.  If a virtual directory is not listed here is means that it inherits the root scriptmap configuration.

To specify the scriptmap of a particular virtual directory (i.e. specify which version of ASP.NET to use):

C:\> aspnet_regiis –sn <path>

For example, running version 1.1 of aspnet_regiis:

C:\> aspnet_regiis –sn “W3SVC/1/ROOT/MyApp2”

will change MyApp2 so that is uses ASP.NET version 1.1 instead of 2.0

Step 3:  Install the ASP.NET client script files in the web root directory.

If these file are either missing or have been corrupted, install them:

C:\>  aspnet_regiis –c

After you perform the steps above, you should be able to run your Iron Speed Designer generated applications with Version 1.1 of Microsoft .NET Framework, even if .NET Framework 1.0 or 2.0 are installed.

See Also

Configuring the Microsoft .NET Framework

Deploying Applications to a Production Server