通过

演练：将 Visual Studio 2005 网站项目转换为 Visual Studio 2008 Web 应用程序项目

  • 项目

更新：2007 年 11 月

本演练介绍如何将 Visual Studio 2005 网站项目转换为 Visual Studio 2008 Web 应用程序项目。Visual Studio 2008 Web 应用程序项目模型与 Visual Studio 2005 Web 应用程序项目模型（.NET Framework 2.0 SP1 中引入的一项功能）类似。有关 Web 应用程序项目的更多信息，请参见 Web 应用程序项目概述。

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

如果网站基于 Microsoft ASP.NET AJAX，则转换过程将需要本演练之外的一些附加步骤。有关更多信息，请参见如何：将 ASP.NET AJAX 1.0 Web 项目升级至 .NET Framework 3.5。

本演练将演示以下任务：

  • 在 Visual Studio 2008 中打开 Visual Studio 2005 网站。

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

  • 创建新的 Visual Studio 2008 Web 应用程序项目。

  • 将 Visual Studio 2005 网站文件复制到新的 Visual Studio 2008 Web 应用程序项目中。

  • 转换 ASP.NET 代码文件。

  • 测试转换后的项目。

先决条件

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

  • Visual Studio 2008.

  • 一个在 Visual Studio 2005 中创建的网站，且不存在编译和运行错误。

转换网站

首先，请在 Visual Studio 2008 中打开该网站，以启动转换过程。

转换网站

  1. 在 Visual Studio 2008 的**“文件”菜单上，单击“打开”，然后单击“网站”**。

    将显示**“打开网站”**对话框。

  2. 浏览至网站文件所在的文件夹，然后单击**“打开”**。

    Visual Studio 2008 将提示您为项目升级 .NET Framework 的目标版本。

  3. 若要升级至 .NET Framework 3.5，请单击**“是”**。

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

    稍后也可以通过项目属性页手动更改 .NET Framework 的目标版本。

测试转换后的网站

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

验证 Visual Studio 2005 网站是否能正常编译和运行

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

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

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

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

    此外，还可能显示**“脚本调试被禁用”**对话框。它指示 Internet Explorer 中已禁用脚本调试。若要对客户端脚本启用调试，请按照该对话框卡中的说明操作。

    单击**“是”**继续调试。

  4. 验证项目是否按预期运行。

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

  5. 在**“解决方案资源管理器”中，右击项目的名称，然后单击“属性”**。

  6. 单击**“引用”**选项卡。

  7. 记下项目中所需的各个引用。

    当在下一节中创建新项目时，必须确保此项目中的所有引用也都出现在新项目中。

创建 Visual Studio 2008 Web 应用程序项目

现在，您可以创建将转换到的 Visual Studio 2008 Web 应用程序项目。

创建 Visual Studio 2008 Web 应用程序项目

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

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

    Web 应用程序项目应创建为 Visual Studio 项目而非网站。

    将显示**“新建项目”**对话框。

  2. 在**“项目类型”下，选择“Web”**。

  3. 选择要在项目中使用的编程语言。

  4. 在**“模板”下，选择“ASP.NET Web 应用程序”**。

  5. 输入项目的名称、位置和解决方案名称，然后在**“解决方案”列表中选择“创建新解决方案”**。

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

    创建项目时，应使其与要转换的 Visual Studio 2005 网站位于不同的文件夹中。这样可以简化转换过程。

  6. 在 .NET Framework 版本列表中，选择转换最初所针对的 .NET Framework 版本。

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

    将关闭现有网站，并创建新的 Web 应用程序项目。

  8. 删除随新项目创建的 Default.aspx 和 Web.config 文件。

  9. 在**“解决方案资源管理器”中，展开“引用”**，然后根据所转换项目以前所需的引用检查默认引用的列表。

  10. 如果需要其他引用，请右击**“引用”节点，单击“添加引用”，然后在“添加引用”**对话框中创建所需的引用。

将文件复制到 Web 应用程序项目中

现在，您可以将项目文件从旧项目复制到新的 Web 应用程序项目中。

将文件从旧项目复制到 Web 应用程序项目

  1. 在 Windows 资源管理器中，浏览至 Visual Studio 2005 网站项目文件所在的文件夹。

  2. 选择要复制到新项目中的文件和文件夹，然后进行复制。

  3. 在 Visual Studio 的新项目的**“解决方案资源管理器”中，右击该项目节点，然后单击“粘贴”**，以将复制的文件添加到新项目中。

转换 ASP.NET 代码文件

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

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

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

转换 ASP.NET 代码文件

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

    随即会转换这些文件。

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

测试 Web 应用程序项目

完成文件转换后，即可对项目进行测试，以确保它能够以 Web 应用程序项目的形式正确运行。

生成并运行转换后的项目

  1. 在**“生成”菜单上，单击“生成”**以编译应用程序。

    项目中丢失的所有引用以及其他编译问题都会显示在**“错误列表”**窗口中。

  2. 运行该项目。

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

后续步骤

如果要将包含 AJAX 功能的 Visual Studio 2005 网站项目转换为 Visual Studio 2008，则整个过程与上述过程类似，但需要执行一些附加步骤。在转换完 Visual Studio 项目后，请执行如何：将 ASP.NET AJAX 1.0 Web 项目升级至 .NET Framework 3.5 中介绍的步骤。

此外，您可能还希望将其他类型的项目从 Visual Studio 的早期版本转换为 Visual Studio 2008。有关更多信息，请参见概述：将 Visual Studio 网站和项目转换至 Visual Studio 2008。

请参见

任务

如何：将 ASP.NET AJAX 1.0 Web 项目升级至 .NET Framework 3.5

概念

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

面向网站的 .NET Framework

迁移和转换 ASP.NET 网站