VS2003-2005 移植

VS2003 WEB应用程序向VS2005的移植

译自：http://webproject.scottgu.com/VisualBasic/Migration/Migration.aspx

作者：Scott Guthrie.

 

VS2003 WEB应用程序向VS2005的移植

 

下面的向导将向你展示，如何快速简便地把VS2003 网络应用程序移植到VS2005平台。请详细阅读第一至第六条指引，目的是让你了解VS2005的网络应用程序的运行模式，因为这和以前BEAT1（和最终版的VS2005存在一定的差异，某些功能在BEAT版里不支持） 和VS2003的运行模式存在着差异。

 

利用VS2005的WEB APPLICATION PROJECT PREVIEW 时行VS2003的程序移植

 

有很多种不同的移植方案，一种默认的移植方式是通过网站应用程序模式。在此，我们利用的是一种非常简单的移植方案，和默认方式的原理一样，你不必要去对程序结构做任何修改。

唯一要做的是忽略API引用的警告。

 

在使用VS2005最终版时，当你打开VS2003的工程项目时，它会提示你，是否对当前打开的项目进行转换。

 

自动移植向导在第一版中并不支持，但是根据下面的指引，你可达到同样的效果。一般来说，你可以在15-20以内完成前八个步骤。（在这里写的太详细了，其实每步可能只要1,2分钟就可完成）。

 

请仔细按照步骤进行操作，如果在移植当中遇到问题（成功最好），那么请来信，我会在下一次的更新中回答你的疑问。

 

STEP 0：安装VS2005 网络应用程序工程项目预揽

 

如果你安装的是VS2005 最终版，那么，你就不必要再进行安装了，因了这项功能已经内置在VS2005里面了，如果你用的VS2005没有此项功能，你可以点击下载并安装，在使用前请仔细阅读说明。

 

STEP 1：备份你要转换的VS2003项目文件

 

在尝试以下步骤之前，请确认你已经对你要转换的项目就行了完整的备份，这样以备不测。因为在转换的过程当中，我们很难保证不出问题，一但出了问题，我们可以利用这个备份进行回转。

 

STEP 2：打开你的VS2003项目，确保项目运行正常

 

在进行转换之前，还要对你的项目做最后的编译和测试，保证没有错误之后，才可下面的步骤。这样做是为了在以后的步骤执行当中减少不必要麻烦（特别是，如果因为最后一次的文件移动所导致的问题）。

 

STEP 3：修改.sln 和 .vbproj 项目文件，使之成为类库文件

 

 如果你使用的是VS2005最终版，那么就不必要做如下更换，因为VS2005会自动帮你完成以下工作。如果是VS2005第一版，请仔细阅读并认真执行。

 

1)        关闭VS2003解决方案

2)        用记事本打开.sln文件，此文件是基于文本的，里面记录着详细的关于解决方案的内容。当你打开一个解决方案文件时，会类似以下的文本内容：

    Microsoft Visual Studio Solution File, Format Version 8.00
  

Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "PortalVBVS", "http://localhost/PortalVBVS/PortalVBVS.vbproj", "{345F0E9A-24F3-451C-B8EE-6B3796797BC8}"
  

        ProjectSection(ProjectDependencies) = postProject
  

        EndProjectSection
  

EndProject
  

Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "ClassLibrary1", "ClassLibrary1/ClassLibrary1.csproj", "{50CC4DB3-6AE3-4A01-A3C8-000DB914F9CF}"
  

        ProjectSection(ProjectDependencies) = postProject
  

        EndProjectSection
  

EndProject
  

Global
  

        GlobalSection(SolutionConfiguration) = preSolution
  

               Debug = Debug
  

               Release = Release
  

        EndGlobalSection
  

        GlobalSection(ProjectConfiguration) = postSolution
  

               {345F0E9A-24F3-451C-B8EE-6B3796797BC8}.Debug.ActiveCfg = Debug|.NET
  

               {345F0E9A-24F3-451C-B8EE-6B3796797BC8}.Debug.Build.0 = Debug|.NET
  

               {345F0E9A-24F3-451C-B8EE-6B3796797BC8}.Release.ActiveCfg = Release|.NET
  

               {345F0E9A-24F3-451C-B8EE-6B3796797BC8}.Release.Build.0 = Release|.NET
  

               {50CC4DB3-6AE3-4A01-A3C8-000DB914F9CF}.Debug.ActiveCfg = Debug|.NET
  

               {50CC4DB3-6AE3-4A01-A3C8-000DB914F9CF}.Debug.Build.0 = Debug|.NET
  

               {50CC4DB3-6AE3-4A01-A3C8-000DB914F9CF}.Release.ActiveCfg = Release|.NET
  

               {50CC4DB3-6AE3-4A01-A3C8-000DB914F9CF}.Release.Build.0 = Release|.NET
  

        EndGlobalSection
  

        GlobalSection(ExtensibilityGlobals) = postSolution
  

        EndGlobalSection
  

        GlobalSection(ExtensibilityAddIns) = postSolution
  

        EndGlobalSection
  

EndGlobal
  

手工对该文件进行修改，把http：//URL定义更改为文件引用类型路径，如上所示就是把http://localhost/PortalVBVS/PortalVBVS.vbproj 改为PortalVBVS/PortalVBVS.vbproj 注意，这里是 “/” 不是 ”/”,因为这里是文件路径. 更改的结果如下:
  

Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "PortalVBVS", "PortalVBVS/PortalVBVS.vbproj", "{345F0E9A-24F3-451C-B8EE-6B3796797BC8}"
  

        ProjectSection(ProjectDependencies) = postProject
  

        EndProjectSection
  

EndProject
  

 

3)        利用记事本对工程文件进行更改

  <VisualStudioProject>
  

    <VisualBasic
  

        ProjectType = "Web"
  

        ProductVersion = "7.10.3077"
  

        SchemaVersion = "2.0"
  

        ProjectGuid = "{345F0E9A-24F3-451C-B8EE-6B3796797BC8}"
  

>
  
    
  

把WEB 更改为 LOCAL 后,保存退出.
  

<VisualStudioProject>
  

    <VisualBasic
  

        ProjectType = "Local"
  

        ProductVersion = "7.10.3077"
  

        SchemaVersion = "2.0"
  

        ProjectGuid = "{345F0E9A-24F3-451C-B8EE-6B3796797BC8}"
  

    >
  

 

4)        最后一步,也是关键的一步,删除与工程相关的.webinfo文件.如果项目名称是LGP.vbproj ,那么就要把LGP.vbproj.webinfo文件删除.

 

STEP 4 重新在VS2003里打开工程，检查项目是否成功打开和编译是否正确

 

一但你完成了以上几个步骤，那么你的Web工程在VS2003中会当作类库看待。他们的意义相同，但是与FrontPage 服务器扩展的连接将不存在。

 

在VS2003中重新打开，检测是否编译完好，注意你必须直接打开解决方案文件，你已经不能再用服务器扩展形式《HTTP：//》打开了。因为你刚才把工程文件转换成了类库文件了。确保你的工程都会在解决方案浏览器窗口打开，然后选择，BuildàBuild Solution 并保证完全编译正确。这很容易完成，最容易出错是的是引用项目的路径问题。或者是.webinfo文件没有删除。如果出现这种错误，关掉VS，排除错误，再进行打开,编译。

 

SETP 5：用VS2005打开并执行移植

 

关闭当前打开的VS2003，打开VS2005。选择 文件à打开文件，选择你要进行转换的工程解决方案。VS2005会自动运行项目移植向导。

根据向导进行移植，VS2005会把工程文件转换为MSBuild类型的文件（VS2005中工程文件专用的格式）。在此过程中会自动产生一个XML格式的转换概要，一般来说，这个文件保存在你当前解决方案的同一目录下。如果在以后的编译过程过程出现了错误,你可以通过查看此文件来追踪错误。

 

STEP 6：转换你的工程项目

 

现在，你的工程已经转换成了VS2005 MSBuild格式的工程文件，下一步就是要添加一个原数据值，让VS2005把它们当成VS2005工程文件来对待。可以这样做：

1）  首先完全保存你打开的文件和已完成转换的文件

2）  关闭解决方案

3）  用记事本打开工程文件进行再次编辑，这次你的工程文件会是如下格式（MSBUILD）：

<Project DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  

  <PropertyGroup>
  

    <ProjectType>Local</ProjectType>
  

    <Configuration Condition=" '$(Configuration)' == '' ">Debug</Configuration>
  

    <Platform Condition=" '$(Platform)' == '' ">AnyCPU</Platform>
  

    <ProductVersion>8.0.50727</ProductVersion>
  

    <SchemaVersion>2.0</SchemaVersion>
  

    <ProjectGuid>{22C5DF64-8114-41F3-92DF-DBC285835584}</ProjectGuid>
  

    <OutputType>Library</OutputType>
  

    <AppDesignerFolder>Properties</AppDesignerFolder>
  

    <RootNamespace>WebApplication10</RootNamespace>
  

    <AssemblyName>WebApplication10</AssemblyName>
  

  </PropertyGroup>
  

删除<ProjectType>行，并用下列值代替：

<ProjectTypeGuids>{349c5851-65df-11da-9384-00065b846f21};{F184B08F-C81C-45F6-A57F-5ABD9991F28F}</ProjectTypeGuids>
  

这个值可以让VS2005知道，不能把它当作普通的类库工程，而是WEB应用程序。

4）  保存并关闭WEB工程文件，重新打开解决方案文件。

 

STEP 7：利用IIS安装WEB应用程序

 

一般情况下，你的Web工程会运行在VS内置的Web服务器（aka Cassini）.当然，你很想充分利用它的优越性，最简单的方法是在IIS里运行。你可以这样做：

 

1）  在解决方案里右键Web应用程序的根结点，选择属性页，然后打开Web标签，选择“Use IIS Web Server”项，输入 Http://工程项目路径

最后，关闭属性页，保存项目文件。

2）  在解决方案中右键，选择作为启动项目。这样在你按F5（或Ctrl-F5）启动解决方案时，会把这个项目作为启动项目。

3）  运行微软的IIS管理工具，打开你刚刚输入的工程路径属性页，选择 ASP.NET标签，确保应用程序使用的是ASP.NET2.0配置（默认情况下是1.1）。

如果你用的是Window server2003的IIS6，还应当注意不要把它放在ASP.NET1.1的应用程序池中，否则会出现在同一个程序池里加载两个不同版本的CLR错误。如果必要,你要新建一个程序池来防止冲突。

 

STEP 8: 处理XHTML的适应性问题

 

在默认情况下，VS2005会自动生成并检测XHTML标记语言，这可以帮你建立通用的网站应用程序，并且减少你的网页在呈现时的误错。

 

不妙的是，VS2003不会自动生成XHTML标记，所以你应当注意在VS2003应用程序里的XHTML配置部分。可以这样来配置：

1）  切换当前配置，把HTML检验变成IE6检验（这在VS2003中是默认的）。选择工具à选项菜单项，在弹出的对话框中，选择文本框选项，把检验目标换成IE6，并且取消“显示错误”项。

2）  你还应当考虑在配置文件中加入下面的标签，这样可以避免在你的页面中看到不同的呈现结果。

<system.web>
  

  <xhtmlConformance mode="Legacy" />
  

</system.web>
  

STEP 9:编译，运行工程项目
    

现在你可以编译你的工程了。在这个阶段最容易发生的错误是新类名称的编译冲突。比如：现在的ASP.NET有内置的菜单和树控件（就像Profile，MemberShip和RoleManagement APIs） ，所以会看到一个‘类型不明确’的错误。（注：编译器会列出所有的错误详细信息）。如果这样，你应当更新你的控件引用名称，用全称来代替。比如：把TreeView 改为myProject.Mycontrol.TreeView。
  

另外一个问题是关于VB的，Global将被视为关键字在VB2005中，这意味着你不能再用它来命名类。在VS2003中，Global.asax文件默认是全局类。在升级的过程中，所有的引用都会被自动的重命名为全局的。如果在你的页面类或是控件类中，引用了全局类，那么你要手工的加上“Add”字符在你引用的类名前。

 

你还可能遇到其它的关于API的变更问题，请访问这个页面，可以帮你了解更详细的情况。

 

一旦你的编译工作正确无误，那么你就可以在IIS中运行调试了。

 

STEP 10：PARTIAL类的转化

 

当你完成上述步骤时，你的内联类和其它类将都不会被修改。它们将像在VS2003里一样。这样可以让移植变得简单。你也可以随意选择你的代码格式，这样需要你手工的去更新你的代码后置类。

 

当然，你也可以利用在VS2005中的新类模式Partial。这样让你的代码看着更简捷，更有逻辑性。这样就把当前的代码后置文件变换成了两个分别的文件：一个是代码和事件处理，另一个是为页面中申明的控件。想了解详细的新类模式，请查看此页。

 

根据下面的步骤转换你的当前类

 

1）  在确认变换前，一定要工程编译没有任何错误

2）  在你的项目浏览器点右键，选择“更新WEB应用程序”，这样会让你的.aspx页面和.ascx控件页的后置代码自动更新为Partial模式，并生成相应的 .Designer.vb代码。

接下来，你要重新编译项目，这样不会出现错误（我所遇到的错误情况大多是，你在代码后置类里修改了控件申明，在更新向导中会错误地处理它们）。如果你有这样的错误，根据错误信息，查找相关的页面，查看代码，更改错误。

 

注意：还有一种更高级的选择，就是一个页面一个页面的更新。只需要要选择你想更新的页面，右键à选择“更新应用程序”项。这样你可以更细致地观察更新过程。

 

当你新增页面时，它会自动默认选用Partial代码后置模板。