演练：将 Visual Studio 2002 或 2003 Web 项目转换为 Visual Studio 2008 Web 应用程序项目

  • 项目

更新：2007 年 11 月

本演练介绍如何将 Visual Studio .NET 2002 或 Visual Studio .NET 2003 Web 项目转换为 Visual Studio 2008 Web 应用程序项目。Visual Studio 2008 Web 应用程序项目模型类似于 Visual Studio 2005 Web 应用程序项目模型。因此，其转换过程十分相似。有关 Web 应用程序项目的更多信息，请参见 Web 应用程序项目概述。

此外，还可以从 Visual Studio .NET Web 项目转换为 Visual Studio 2008 网站项目。但是，转换为 Web 应用程序项目是受支持的做法，并可获得便利的工具来帮助完成转换。例如，在转换为 Visual Studio 2008 Web 应用程序项目时，可以使用 Visual Studio 转换向导自动处理此过程的部分内容。有关如何将 Visual Studio .NET Web 项目转换为 Visual Studio 2008 网站的信息，请参见 Common Web Project Conversion Issues and Solutions（常见 Web 项目转换问题和解决方案）。

在将 Visual Studio 2002 或 2003 Web 项目转换为 Visual Studio 2008 Web 应用程序项目时，涉及两个部分。这两个部分如下：

  • 转换项目。您可以使用 Visual Studio 转换向导完成项目和 Web.config 文件的初始转换。随后，可以使用**“转换为 Web 应用程序”**命令更新项目的文件和结构。

  • 升级项目的 .NET Framework 版本。必须将项目的 .NET Framework 版本升级至 .NET Framework 2.0 SP1 或 .NET Framework 3.5。之所以需要此 .NET Framework 版本升级操作，是因为 Visual Studio 2008 不能用于 .NET Framework 的早期版本。您可以在项目转换期间使用转换向导执行此升级，也可以在转换项目之后再升级 .NET Framework 的版本。

    Bb907676.alert_note(zh-cn,VS.90).gif说明：

    您可以手动更改项目的 .NET Framework 版本。若要执行此操作，请在 Visual Studio 中打开项目的属性页，单击“应用程序”选项卡，然后从“目标 Framework”列表中选择一个新版本。

本演练阐释以下任务：

  • 在 Visual Studio 2008 中打开 Visual Studio .NET 项目并创建项目文件的备份。

  • 升级项目的目标 .NET Framework 版本。

  • 转换项目文件和 Web.config 文件。

  • 转换 ASP.NET 代码文件。

  • 测试转换后的项目。

先决条件

若要完成本演练，您需要：

  • Visual Studio 2008。

  • 一个在 Visual Studio .NET 2002 或 2003 版中创建的网站项目，且没有编译和运行错误。

转换项目和升级 .NET Framework 版本

首先，请在 Visual Studio 2008 中打开该项目，以启动转换过程。转换之前会为您提供备份项目的机会。

Bb907676.alert_note(zh-cn,VS.90).gif说明：

强烈建议备份项目。该转换处理的是原始项目文件，如果转换失败，将无法进行恢复。

转换项目并备份文件

  1. 在 Visual Studio 2008 的**“文件”菜单中，单击“打开”，然后单击“项目”**。

    将显示**“打开项目”**对话框。

  2. 通过浏览找到 Visual Studio .NET 项目的项目文件或解决方案文件所在的文件夹，选择该文件，然后单击**“打开”**。

    Bb907676.alert_note(zh-cn,VS.90).gif说明：

    请确保使用“打开项目”命令打开项目。如果使用“打开网站”命令，项目将被转换为网站项目格式。

    随即将打开转换向导，并提示您是否要在转换项目之前创建备份。

  3. 若要创建备份，请单击**“是”**。

  4. 单击**“浏览”，选择应创建备份的文件夹，然后单击“下一步”**。

  5. 单击**“完成”**。

    随即开始备份。

    Bb907676.alert_note(zh-cn,VS.90).gif说明：

    转换向导在复制文件时可能会有明显的延迟，并且不显示更新或进度。请等待，直到进程结束再继续。

    转换结束时，向导将提示您是否升级项目的目标 .NET Framework 版本。

  6. 若要升级至 .NET Framework 3.5，请单击**“是”。若要将项目的目标版本升级至 .NET Framework 2.0 SP1，请单击“否”**。

    建议将询问是否要升级项目中的所有 Web 的复选框保留为选中状态。

    如果升级至 .NET Framework 3.5，则会同时修改项目的 Web.config 文件和项目文件。

    当升级和转换完成时，将显示一条消息，指示已完成项目转换的第一步。

  7. 单击**“确定”**。

    向导将显示有关转换的状态信息。

  8. 单击**“关闭”**。

测试转换后的项目

完成转换后，即可对项目进行测试，以确保其能够正常运行。此过程还有助于识别项目中需要更新的代码。

验证项目是否正常运行

  1. 如果已知代码在使用新版本的 .NET Framework 运行时所需的相关更改，请实施这些更改。

  2. 在**“生成”菜单上单击“生成”**。

    项目中丢失的所有引用以及其他编译问题都会显示在**“错误列表”**窗口中。最可能出现的问题是程序集引用丢失，或动态生成的类型有问题。

  3. 在**“解决方案资源管理器”中，右击将用于启动应用程序的网页，然后单击“设为起始页”**。

  4. 在**“调试”菜单上单击“启动调试”**。

    如果未启用调试，将显示**“未启用调试”对话框。请选择用于添加已启用调试的 Web.config 文件的选项，然后单击“确定”**。

  5. 验证转换后的项目是否按预期运行。

    只有解决了所有生成和运行时错误，才能继续此转换过程。

转换 ASP.NET 代码文件

Visual Studio 2008 中使用代码隐藏模型的 ASP.NET 网页文件和用户控件文件都有一个关联的设计器文件。而刚转换完的文件将具有关联的代码隐藏文件，而不是设计器文件。因此，下一步是生成设计器文件。

Bb907676.alert_note(zh-cn,VS.90).gif说明：

只有代码位于单独代码文件中的 ASP.NET 网页和用户控件才需要单独的设计器文件。对于使用内联代码且没有关联代码文件的页面，将不会生成设计器文件。

转换 ASP.NET 代码文件

  1. 在**“解决方案资源管理器”中，右击该项目节点，然后单击“转换为 Web 应用程序”**。

    随即会转换这些文件。

  2. 验证转换后的代码文件是否都具有一个代码文件和一个设计器文件。

  3. 生成并运行项目，以验证转换的结果。

请参见

概念

概述：将 Visual Studio 网站和项目转换至 Visual Studio 2008

Web 应用程序项目概述

其他资源

从 Visual Studio .NET 2002 或 2003 进行转换