将 Web 项目从 Visual Studio Net 2003 转换到 Visual Studio 2005 的分步指南.docx

转换注意事项在考虑将VisualStudio.Net2003Web项目转换为VisualStudio2005格式的最佳做法之前，需要了解转换的优点并确定转换是否有意义。转换的决定最终取决于具体的应用程序和情况。如果您有一个正在使用的应用程序并且不常更新，则转换它可能没什么意义，因为这么做的好处可能很有限。如果选择不将应用程序转换为VisualStudio2005语法，仍有两种选择可以考虑：1.在应用程序虚拟目录的IIS设置中，保持将该应用程序映射到ASP.Net1.1（或1.0）。继续使用VisualStudio.Net2003编辑应用程序代码。2.在IIS设置中，将应用程序映射为在ASP.Net2.0下运行，但不要从VisualStudio.Net2003中升级项目格式。在本例中，应用程序将受益于ASP.Net2.0中的几个安全性和性能增强功能，不过您需要继续使用VisualStudio.Net2003来编辑应用程序代码。注：您可以在同一台IIS服务器上同时运行ASP.Net1.1和ASP.Net2.0应用程序。将Web应用程序项目转换到VisualStudio2005的主要优点是，能够在现有应用程序中使用ASP.Net2.0的许多新增功能（例如，母版页等）。如果您希望增强一个现有的、用VisualStudio.Net2003生成的Web应用程序，升级到VisualStudio2005可能是最正确的决定。对转换Web项目的预期对于相对简单的Web项目（其中一个Web项目是VisualStudio.Net2003解决方案中的唯一项目），转换应该是一个相对自动的过程，需要很少的时间或问题解决方案。如果要转换的应用程序大小合理，并且一个VisualStudio解决方案中有几个Web项目和其他项目（如类库），则在迁移期间可能会遇到问题。做好准备用一天中较好的一段时间来完成整个过程。本文提供的步骤和指导可以帮助信息完备的用户迁移大多数中等复杂程度的应用程序。返回页首第一部分：准备要转换的VisualStudio.Net2002/2003Web项目在VisualStudio.Net2003中配置应用程序升级项目时，建议将VisualStudio.Net2002/2003和VisualStudio2005安装在同一台计算机上。准备迁移VisualStudio.Net2003Web项目时，首先要确保该项目已配置并且在VisualStudio.Net2003环境中正常运行。如果要升级一个其解决方案中包括多个项目的应用程序，则确保在isualStudio.Net2003内部生成和运行整个解决方案，然后才能进行迁移。即使要升级一个由单个Web项目表示的应用程序，还是要打开解决方案文件并在VisualStudio.Net2003中测试和运行应用程序。为此，请在VisualStudio.Net2003中单击OpenSolution。当解决方案在VisualStudio.Net2003中打开时，单击Build菜单上的BuildSolution，以确保应用程序编译不会出错。图1.生成解决方案要运行此应用程序，请在VisualStudio.Net2003中按F5，并确保该应用程序正常运行，不会出错。确保尝试解决方案中所有Web项目中的页，以确保IIS配置正确，可以支持应用程序页。将排除的文件移到Web项目外另一个可以将潜在问题降到最少的措施是，将所有排除的文件从您的Web项目中删除。如果在Web项目文件夹结构中存在任何不被解决方案中的任何Web项目引用的文件，则将这些文件移到一个单独的位置，然后再迁移您的解决方案。要帮助找到这些排除的文件，您可以使用解决方案资源管理器中的ShowAllFiles按钮。图2.显示隐藏文件检查重复的项目文件另一个可能产生迁移问题的项目结构问题是，IISWeb应用程序的根文件夹中有多个项目文件。通常，给定的IISWeb应用程序的根文件夹中只有一个项目文件（*.vbproj或*.csproj），但有时存在多个项目文件。IISWeb应用程序的根文件夹中有多个项目文件，一个常见的原因是，如果您有一个包含多个Web项目的解决方案，则每个项目都在该Web应用程序中生成单独的一组页面。这种类型的解决方案结构使用户可以在单个Web应用程序中将一组不同的页面组成不同程序集。下面描述这种结构的一个示例。如果在IISWeb应用程序的同一个根文件夹下有多个Web项目，只要每个项目不包括相同的一组文件，您在迁移期间就可能不会碰到任何问题。如果在多个Web项目中引用了相同的文件集或子文件集，则这些普通文件将被迁移两次并且出错。这种情况通常发生在创建了现有项目文件的备份副本后，这样会产生两个具有一组完全相同文件的Web项目文件。如果在Web应用程序的根文件夹中有多个Web项目文件并且它们引用相同的文件集，则确保删除该解决方案不使用的任何项目文件，以保证Web项目中的文件不会迁移两次。检查包括相同Web项目的多个解决方案推荐的过程是迁移整个VisualStudio解决方案，尽管可能有几个解决方案代表正在迁移的应用程序。在这种情况下，您可能每次迁移一个解决方案，以便将整个应用程序转换到VisualStudio2005。例如，如果两个VisualStudio解决方案包括同一个Web项目并且尝试对它们进行升级，则在迁移第二个解决方案时可能会出现错误。为了避免这种情况，请迁移第一个解决方案。迁移第二个解决方案时，从第二个解决方案中删除所有作为第一个解决方案一部分已进行迁移的Web项目。删除已迁移的Web项目后，即可迁移第二个解决方案，不会产生任何问题。迁移第二个解决方案后，可以重新添加已迁移的Web项目。删除对Web项目的引用如果您有一个包含多个项目的解决方案，确保不存在对解决方案中Web项目的任何引用也非常重要。这种模式的一个示例如下：如果有两个Web项目（WebProjectA和WebProjectB），则WebProjectB引用WebProjectA以使用WebProjectA中的某些类。图3.删除Web项目引用解决方案迁移到VisualStudio2005后，在VisualStudio.Net2003中启用的该模式将不再起作用。幸运的是，可以修改解决方案代码来避免这种情况。为此，可以通过将共享代码移动到类库，并从该类库引用共享代码来使用与上一部分类似的模型。我们将使用WebProjectA和WebProjectB的简单示例（它有一个对WebProjectA的项目引用）来阐述如何执行该操作：1.使用FileAddProjectNewProject向解决方案添加相同语言（VisualBasic或C#）的新ClassLibrary项目。2.对于WebProjectB需要的、WebProjectA中的任何类，将这些类复制到新的ClassLibrary项目中。3.在WebProjectB中删除对WebProjectA的引用4.在WebProjectA和WebProjectB中，向第3步中创建的ClassLibrary项目添加一个新的“项目引用”。5.使用上面提供的指导重新构建解决方案后，进行检查以确保在VisualStudio.Net2003中干净地生成解决方案。完成解决方案生成后，运行整个应用程序以确保它仍具有全部功能。图4.迁移Web项目后的解决方案返回页首第二部分：迁移您的Web项目运行VisualStudio2005MigrationWizard使用第一部分中的准则重新构建VisualStudio.Net2003解决方案，并正确验证整个解决方案的生成和运行后，现在该准备迁移到VisualStudio2005了。升级应用程序时，最佳做法是在已经使用VisualStudio.Net2003进行测试和运行的计算机上进行迁移。VisualStudio2005完全可以与VisualStudio.Net2003安装在同一台计算机上，因此您应该能够在同一台计算机上安装VisualStudio2005，而不产生任何问题。在同一台计算机上安装VisualStudio2005后，通过打开代表应用程序的解决方案文件来升级应用程序。虽然有可能打开单个项目并迁移它们，但最省事的途径是迁移整个解决方案。为此，请在VisualStudio2005中单击OpenProject，并打开表示待升级应用程序的解决方案文件(*.sln)。屏幕将显示以下内容，指示可以开始迁移过程：图5：转换向导为了获得最好的结果，请遵循此向导中提供的默认值以开始迁移。备份应用程序在该转换向导显示的步骤中，请密切关注创建解决方案的备份副本。重新检查，确保选择了Yes选项以创建备份，而且一定要注意备份位置，以便将来恢复VisualStudio.Net2002/2003Web应用程序的备份。图6.备份项目返回页首第三部分：完成迁移的迁移后步骤检查转换报告完成ConversionWizard后，会生成一份概括了迁移过程结果的XML报告。图7.转换报告一定要注意文档窗口顶部URL字段中显示的XML文件的位置。记下此位置，以便在关闭文件后可以再次引用XML转换报告。除报告解决方案中所有项目的错误和警告的XML报告以外，每个Web项目都包含一个ConversionReport.txt文件，该文件具有与解决方案中的特定Web项目相同的信息。XML报告概括解决方案中每个项目的结果。折叠报告时，您可以快速确定解决方案中的每个项目生成的警告和错误的数量。展开每一部分后，可以详细查看特定项目的警告和错误。对于最简单的应用程序，转换报告可能会显示解决方案中的所有项目均成功迁移。在大多数具有中高等复杂性的真实情况中，更可能的结果是报告某些迁移错误和警告，并需要对它们进行调查。以下部分介绍解决报告的问题时使用的最有效方法。首先确保编译类库项目通常，用来解决任何所报告问题的最好方法是修复解决方案中的每个项目，首先从共享组件开始，一次修复一个。例如，如果解决方案中存在引用其他项目（如类库项目）的Web项目，则先解决被引用项目中报告的所有问题。为此，对于Web项目引用的每个项目，右击各个项目，然后选择BuildProject以确保它进行编译。图8.先生成类库如果进行转换之前就在VisualStudio.Net2003中对整个解决方案进行了干净的编译，则在类库项目中可能遇到的编译错误是与保留关键字的冲突或框架中的新增类型，应该直接修复。修复每个Web项目中的转换错误和警告修复了解决方案中类库项目报告的任何错误后，下一步是修复每个Web项目中报告的错误和警告。对于每个Web项目，使用以下准则作为解决所发现问题的方法：1.打开Web.config文件，并关闭批编译。通过将编译标记中的batch=false属性设置成以下形式，可以实现该操作：。关闭批编译可降低掩盖应用程序中可能存在但未报告的编译错误的可能。2.通过打开Web项目根文件夹中的conversionreport.txt文件来查看已报告的警告和错误。该文本文件包括迁移期间标题为Errors、Warnings和Comments的部分。查看Errors部分和Warnings部分，并尝试使用以下方法解决问题（Comments部分主要是提供信息，无需任何操作）：1.如果在转换文件中看到有关以前所转换“被排除的”文件的任何警告，建议您先删除这些文件，因为它们会导致许多干扰识别和修复应用程序中其他错误的编译错误。2.为了完成conversionreport.txt文件中报告的其他错误和警告的剩余部分，请参阅“CommonASP.Net2.0ConversionIssuesandSolutions”，以了解有关如何解决可能报告的每个警告和错误的具体指导。3.解决conversionreport.txt文件中的所有错误后，生成Web项目以解决可能存在的任何其他的编译错误。为此，请选择您正在使用的Web站点项目的根节点，并在Build菜单上选择BuildWebSite。请再次参阅“CommonASP.Net2.0ConversionIssuesandSolutions”，以了解任何可能报告的特定编译错误，并获得有关如何纠正这些错误的指导。4.解决报告的问题且Web项目成功编译后，还有两个推荐的步骤：1.Web项目中显示的许多*.resx文件可能不再需要。通过与aspx文件或ascx文件相同的前缀名称，可以轻松识别这些文件（例如，default.aspx.resx）。无论是否需要，VisualStudio.Net2003都为每一页创建资源文件。大多数情况下，这些文件为空（或者包含应用程序不用的资源）并且可以被删除。2.将conversionreport.txt重命名为conversionreport.Webinfo。因为conversionreport.txt可以通过Web浏览器查看，并且可能会显示有关您站点的敏感信息，所以建议执行该操作。通过将该文件重命名为conversionreport.Webinfo，默认情况下不能通过Web浏览器访问它。修复每个Web项目中的运行时问题在VisualStudio2005中对所有类库和每个Web项目进行干净的编译后，下一步就是运行整个应用程序并验证功能。在您测试应用程序功能时，可能会遇到一些运行时异常，这些异常可能是由于违反了ASP.Net1.1和ASP.Net2.0之间引入的改变而产生的。“CommonASP.Net2.0ConversionIssuesandSolutions”有助于识别这些错误并对其进行修复。返回页首第四部分：其他信息本文档前面的部分介绍了将Web项目从VisualStudio.Net2003转换到VisualStudio2005的整个分步过程。下列部分包括其他有用的信息：HTML/XHTML验证错误您可能会遇到IDE中的ASPX页和ASCX页处于打开状态时报告的验证错误。默认情况下，可能会报告这些额外错误，因为VisualStudio2005拥有基于XHTML1.1标准的更严格的HTML验证。这些不是编译错误，不会影响应用程序的功能。如果一个ASPX页或ASCX页处于打开状态，则这些错误和编译错误出现在同一个错误列表中，因此可以通过增加要查看的错误总数来增加复杂性。可以执行一些操作来推迟处理这些验证错误。将VisualStudio2005中的默认验证改为“InternetExplor