如何：重写默认的控件模板

  • 项目

上次修改时间： 2010年7月7日

适用范围： SharePoint Foundation 2010

通过将定义自定义用户控件的 .ascx 文件添加到 %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\CONTROLTEMPLATES 中，可重写随 Microsoft SharePoint Foundation 一起安装的现有默认表单模板。自定义控件模板和默认模板必须具有相同的标识符 (ID)。

示例

下面的控件模板示例重写其 ID 为 DocumentLibraryForm 的默认控件模板。该模板会向表单底部添加一条消息，其中包含指向其他页面的链接。

<SharePoint:RenderingTemplate ID="DocumentLibraryForm" runat="server">
  <Template>
    <SharePoint:InformationBar runat="server"/>
    <wssuc:ToolBar CssClass="ms-formtoolbar" id="toolBarTbltop" RightButtonSeparator="&nbsp;" runat="server">
      <Template_RightButtons>
        <SharePoint:SaveButton TabIndex=1 runat="server"/>
        <SharePoint:GoBackButton runat="server"/>
      </Template_RightButtons>
    </wssuc:ToolBar>
    <SharePoint:FormToolBar runat="server"/>
    <SharePoint:FormComponent TemplateName="DocumentLibraryFormCore" runat="server"/>
    <div style="padding-top: 40px; font: 8pt Tahoma;">
      <span style="color: red; font-weight: bold">Warning:</span>   This site contains customer data and information. <a href="_layouts/moreinfo.aspx">More information on customer data protection.</a>
    </div>
  </Template>
</SharePoint:RenderingTemplate>

为文档库创建自定义控件模板文件

  1. 在 Microsoft Visual Studio 中，创建一个用户控件 (.ascx file)，如如何：为 SharePoint 应用程序页或 Web 部件创建用户控件中所述。

  2. 将模板定义添加到可重写特定默认控件模板（例如上南的示例）的 .ascx 文件。

  3. 重置 Internet Information Services (IIS) 以使更改生效。

  4. 导航到文档库中某项的表单以查看更改。