相信很多人都在使用用户控件包装器来开发Web Part，原因很简单，创建一个用户控件比直接用代码来写一个Web Part要简单N倍，特别对于界面比较丰富的Web Part而言。实际上，不仅仅你有这样的感觉，就连SharePoint产品开发组都有这样的感觉。在SharePoint Server 2007里面，对于界面就大量使用了用户控件。不相信？用资源管理器打开SharePoint服务器上的“C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\CONTROLTEMPLATES”目录，看到了什么？是不是一大堆.ascx用户控件？如果你再尝试用记事本打开这个目录下的“SearchArea.ascx”，猜猜你看到的是什么？没错，这个用户控件就是出现在SharePoint页面右上方的那个搜索框。
那么SharePoint Server 2007自己是如何将这些用户控件放到SharePoint页面上的呢？就是通过DelegateControl这个东东。DelegateControl位于Microsoft.SharePoint.WebControls命名空间之下，你可以在SharePoint SDK里面看到关于它的内容。
下面我们来利用DelegateControl，将我们自己创建的一个用户控件放到SharePoint页面上。
首先，用Visual Studio 2005创建一个用户控件，向用户控件窗体上拖一个Calender控件。为了减少部署的复杂性，我们直接将这个用户控件的后台代码写到.ascx里面，而不采用Code-Behind的方式。
在“C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\CONTROLTEMPLATES”这个目录下创建一个新的子目录“CalendarDemo1”，将我们做好的“CalendarDemo1.ascx”文件放到这个目录中。
为了将我们创建的用户控件“安装”到SharePoint Server上，我们需要用到“Feature”这个新的SharePoint Server特性。我们来创建一个新的Feature.xml文件：
然后再创建一个“Control.xml”，来描述用户控件的信息，注意，在这个文件中，我们将控件命名为“CalendarDemo1”（Id="CalendarDemo1"）：
在服务器的“C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\FEATURES”目录创建一个新的子目录“DelegateControlDemo1”来放我们的Feature。将“Feature.xml”和“Control.xml”这两个文件拷贝到这个目录中。
然后在服务器的命令提示符里面执行“stsadm -o installfeature -filename DelegateControlDemo1\Feature.xml”来安装这个Feature：
由于在“Feature.xml”中，我们指定了这个Feature是安装到服务器场（Farm）上面的，所以我们现在打开SharePoint 3.0管理中心，应该是可以在“管理服务器场功能”里面看到我们命名为“DelegateControlDemo1”的Feature的：
确认“DelegateControlDemo1”这个Feature是处于启动状态的。现在，用SharePoint Designer打开这个服务器场里面的一个SharePoint站点，打开一个页面，在代码视图中直接写入：
其实就是很简单的一句：<SharePoint:DelegateControl ControlId="CalendarDemo1" RunAt="server" />，DelegateControl控件的其他属性的用法可以从上面给出的SDK里面查到。
现在在IE中打开SharePoint页面，我们就可以看到：
在Patrick Tisseghem的blog上，也有一篇介绍DelegateControl的文章。
打印 | 张贴于 2006-11-19 20:40:00 | Tag:SharePoint
留言反馈
Feature.xml文件：
Id属性必须是一个Guid，你可以自己用VS2005里面内置的工具创建一个，然后填上即可。
这个要怎么取得?如何操作
<Element>
<Control Id="CalendarDemo1" Sequence="100" Url="~/ControlTemplates/CalendarDemo1/CalendarDemo1.ascx"/>
</Element>
<Element>
<Control Id="CalendarDemo1" Sequence="90" Url="~/ControlTemplates/CalendarDemo1/CalendarDemo1_1.ascx"/>
</Element>
也就是同时注册了两个ID相同的Control，但是其Sequence和Url的值是不同的，这时候如果在masterpage或者page layout里使用<SharePoint:DelegateControl ControlId="CalendarDemo1" RunAt="server" />的话，运行时实际使用的是CalendarDemo1_1.ascx，也就是使用的是Sequence值最小的那个Control。
Feature.xml文件：
Id属性必须是一个Guid，你可以自己用VS2005里面内置的工具创建一个，然后填上即可。
Control.xml文件：
Id属性表示了这个控件的Id，用一个你喜欢的名称即可，比如“MyCalendarControl”。
Required attribute 'Id' is missing from tag 'Feature' in
feature with ID '00000000-0000-0000-0000-000000000000'.