SharePoint Delegate Control

    Delegate Control代理控件如同一个控件的容器，它提供了一种机制容许在不直接修改控件的前提下将代理控件内的控件替换成为自定义的控件。代理控件很相似于PlaceHolder，可是它和PlaceHolder的最大区别在于其内包含的控件能够被替代，称之为代理控件。

SharePoint 提供了很多的delegate controls:

    AdditionalPageHead
    GlobalSiteLink0
    GlobalSiteLink1
    GlobalSiteLink2
    PublishingConsole
    QuickLaunchDataSource
    SmallSearchInputBox
    TopNavigationDataSource

下面是Sharepoint Fundation的MasterPage定义的一些Delegate Controls

<SharePoint:DelegateControl runat="server" ControlId="AdditionalPageHead" 
AllowMultipleControls="true"/>
<SharePoint:DelegateControl runat="server" ControlId="GlobalNavigation" />
<SharePoint:DelegateControl runat="server" ID="GlobalDelegate0" ControlId="GlobalSiteLink0" />
<SharePoint:DelegateControl ControlId="GlobalSiteLink2" ID="GlobalDelegate2" Scope="Farm"
 runat="server" />
<SharePoint:DelegateControl runat="server" ControlId="PublishingConsole" 
Id="PublishingConsoleDelegate">
</SharePoint:DelegateControl><SharePoint:DelegateControl ControlId="GlobalSiteLink3" Scope="Farm" 
runat="server" />
<SharePoint:DelegateControl runat="server" ControlId="SmallSearchInputBox" Version="4" />
<SharePoint:DelegateControl runat="server" ControlId="TopNavigationDataSource" 
Id="topNavigationDelegate"/>

    上面所列举的Delegate controls能够在运行时被用户自定义的控件或Feature动态替换。咱们这里所须要实现的建立自定义SearchBox功能就须要经过用咱们自行开发的MySearchBox用户控件代替 Small Search Input box这个delegate control来实现。

   让咱们来看一看delegate control 的XML schema

<?xml version="1.0" encoding="utf-8" ?> 

<Elements xmlns="http://schemas.microsoft.com/sharepoint/">

<Control Id="SmallSearchInputBox" Sequence="100" ControlSrc="/templates/mysearchcontrol.ascx"/>

</Elements>

    从上面的schema，咱们能够看出,delegate control的重要属性包括 Control Id, Sequence 和 ControlSrc.

    Control Id 是咱们用来识别Delegate control的

    Sequence  number 是咱们用来定位Delegate control的等级的，它的值越小则等级越高。

    ControlSrc 则用来指明Delegate Control的控件资源的位置的。

 

  

   关于SequenceNumber咱们能够进一步用图示说明

   
 

  在上图的示例中，针对同一Delegate control咱们定义了3个用户控件并经过3个Feature(A,B,C)来启用它们，但注意，它们有不一样的Sequence(A>C>B),全部这3个user control都会被用来代替那个指定的Delegate Control，但因为Feature B的Sequence Number最小，因此，Feature B中的usercontrol在Runtime的时候会取得最终的代替权，并被Render到Page中呈现出来。可是，当Feature B被中止时，Feature C就会顶替上来，由于Feature C中的Sequence仅次于Feature B，当Feature B被中止后，Feature C就成了最小的了，因此，它就会取得最终的胜利。

有了上面的知识准备，回到本文的目标，建立一个用户自定义的SearchBox。

   首先建立一个新的项目，在此项目里添加一个新的用户控件，在此用户控件中拖放一个日历控件，咱们就用此日历控件来示例如何代替默认的SearchBox控件。

 

  项目以下图

 

  而后，咱们须要在系统中添加一个Feature，命名此Feature以下
  

  在此Feature中，咱们定义了Scope的范围是站点的级别的，那就意味着你整个站点页面中的搜索控件都会被替换为你本身定制的样式。 

  接下来，咱们须要新添加一个Elment.xml，以下图。

 

   须要注意的是，Sequence属性的值必定要小于默认提供的，这个Sequence的值在wss中是100，在moss标准版中是50，企业版是25。

   在MOSS的安装目录下搜索指定feature中对应的xml文件，打开它能够看到里面所定义的Sequence值（名字:SearchArea.xml）。

   最后，编译部署，打开咱们的测试网站能够看到效果以下图.

原文连接：http://www.cnblogs.com/wsdj-ITtech/archive/2011/11/26/2263041.html