移动项目开发笔记(一个用户控件引起对asp.net 2.0编译的思考)

一、起因:    
     开发团队的一名开发人员突然离职，他把他负责的模块任务交给了我。其中一个模块是他写了一个用户控件，我在我的页面尚始终都用不起，运行时发生错误，错误消息是：The base class includes the field *****, but its type (****) is not compatible with the type of control (ASP.webusercontrol_ascx).
 二、经过:
    遇到这个问题后个人感觉那个用户控件在页面上注册没有成功。查找了页面注册代码：

<%@ Register Src="ProjectInfo.ascx" TagName="ProjectInfo" TagPrefix="uc3" %>
<uc3:ProjectInfo ID="ProjectInfo1" runat="server" />

通过反复的查找都发现这个代码没有问题，我也查找以前的用户控件页是这样注册的。那到底是那儿出了问题了呢?功夫不负有心人，终于找到问题所在了，用户控件的申明是这样写的

<%@ Control Language="C#" AutoEventWireup="true" CodeFile="ProjectInfo.ascx.cs" Inherits="ProjectInfo" %>

问题就在那CodeFile，由于所在的项目是Web Application应用程序，申明的用户控件应该是CodeBehind，怎么回变成CodeFile呢？终于找到问题所在了。当我把CodeFile修改成CodeBehind后页面就能正常显示了。那这儿被谁谁修改成CodeBehind了。通过查看VSTS修改历史，没有人对这个文件进行修改，当时增加这个文件的时候就已经是CodeFile了。Web Application默认增加的用户控件都是CodeBehind的。除非不是Web Application，当时我就建立的一个web site站点，就添加了一个用户控件，一看果然是这样什么的:

<%@ Control Language="C#" AutoEventWireup="true" CodeFile="ProjectInfo.ascx.cs" Inherits="ProjectInfo" %>

 问题的来源页找到了，原来这个用户控件是通过Web Site站点添加的移植过来的而引起的。谢谢上帝，终于把这个问题解决了。
三、思考
问题找到了。问题的来源页找到了。那么为什么这里用CodeFile就不行了。这个才是问题实质。为什么Web Application申明的控件或者页面都是用CodeBehind而不是用CodeFile来申明？
四、 结果
通过不断的查找原因，终于把Web Application用CodeBehind而Web Site用CodeFile找到了?
原来Web Application和Web Site的编译机制是不同的。
Web Site：当我们使用VS.net创建一个页面的时候，VS会自动的创建一个CodeBehind文件，但是当我们编译站点的时候，VS.net会自动的根据页面文件的内容，生成一个临时的”Partial”类，然后把这个partial类和CodeBehind中的partial类整合编译，最后生成一个位于bin中的dll文件。（CodeFile来实现）
Web Application:当我们在页面上加入一个新的控件时候，VS.net自动会在 CodeBehind代码中增加一个Protected对象的申明（Partial类），并在代码中使用和操作这个对象，VS.net会时刻维护页面文件的控件与 （Partial类代码文件的申明）之间同步。当我们编译站点时，VS.net将所以CodeBehind文件编译在一起，生成一个位于bin目录中的dll文件。（CodeBehind来实现）

通过上面的比较后，我们现在已经是比较明白上面的用户控件申明应该用CodeBehind而不能用CodeFile。其根本原因就是：Web Application的页面用的是CodeBehind的方式，如果里面的用户控件又用CodeFile的方式来编译的化，就出现矛盾，那么页面就优先于用户控件的方式，直接把所有的代码文件编译成dll文件就可，而不是把页面文件生成一个partial类再和代码文件一起编译。因此那样的话页面的用户控件将不会被VS.net根据页面的内容生成一个临时类和CodeBehind中的Partial类整合编译，缺少对用户控件的申明，从而会出现：The base class includes the field *****, but its type (****) is not compatible with the type of control (ASP.webusercontrol_ascx).

其他参考资料: http://blog.csdn.net/ups216/archive/2006/09/06/1186835.aspx