This documentation is archived and is not being maintained.

How to: Run ASP.NET 1.x Applications in the .NET Framework 2.0

This topic demonstrates how to run an ASP.NET version 1.x Web application in the .NET Framework version 2.0. As a prerequisite, the ASP.NET 1.x Web application should be able to run in the .NET Framework 1.x version with which it was developed.

The .NET Framework allows you to install multiple versions of the common language runtime on the same computer. Installing the .NET Framework 2.0 will not disrupt any existing applications that are running on previous versions of the .NET Framework. The .NET Framework 2.0 is designed to have a high degree of backward compatibility with applications built with previous versions of the .NET Framework. An application running on a previous version of the .NET Framework can be made to run on the .NET Framework 2.0 by mapping the application to use the ASP.NET 2.0 ISAPI extension (Aspnet_isapi.dll). For more information on running multiple versions of the .NET Framework side by side, see ASP.NET Side-by-Side Overview.

Running an ASP.NET 1.x application in the .NET Framework 2.0 allows you to use ASP.NET 2.0 features in your application's pages. If you choose to migrate your application, you should review what's new in ASP.NET, and in particular review changes to the page code-behind model, Web site folder structure, and dynamic page compilation. For more information on migrating from ASP.NET 1.x to ASP.NET 2.0, see Migrating ASP.NET 1.x Applications to ASP.NET 2.0.

To configure a 1.x application's script map to use the .NET Framework version 2.0

  1. On the Start menu, click Run.

  2. In the Open box, type inetmgr and click OK.

  3. In Internet Information Services (IIS) Manager, expand the local computer, and then expand Web Sites.

  4. Select the target Web site that is running in the .NET Framework version 1.x.

  5. Right-click the name of the virtual directory for the Web site, and then click Properties.

    The <WebSiteName> Properties dialog box appears.

  6. In the ASP.NET version selection list, choose the .NET Framework version 2.0.

  7. Click OK.

  8. Navigate to a page in your application and confirm that your application runs as expected.