本次演练中将向大家展示如何通过实现一个自定义RenderingTemplate控件来对mobile页面中字段的渲染进行定制。示例展示了如何在mobile的显示页面中定制通知列表的项的标题字段的显示。
正如先前在mobile页面渲染机制一节所描述的,一个Microsoft.SharePoint.MobileControls.SPMobileListFIEldSelector 模板选取器控件会被调用,并通过一条链的调用,最终找到显示在页面中的控件。
基于当前的列表类型和字段(比如本例中的通知和标题),该对象决定了哪个RenderingTemplate会用于在mobile显示页面上渲染该字段。
该控件搜寻 RenderingTemplate 对象名称 MobileCustomListField_ListTypeID_FieldType_Field,其中 ListTypeID 可以是当前列表类型的ID号(如105),也可以是SPListTemplateType枚举的一个值(如Contacts)。FieldType 是字段的数据类型。比如,Text或Number。Field 是字段的内部名称,比如WorkPhone。如果该ID不存在,则使用ID为MobileDefaultListField的 RenderingTemplate 对象。
WSS 3.0并没有内置ID为MobileCustomListField_Announcements_Text_Title的RenderingTemplate。在本次演练中,您将创建一个新的用于通知列表的列表项标题字段的模板,来替换默认模板。
定制通知项的标题:
在文本编辑器中,创建一个文本文件 (UTF-8),命名为AnnouncementsItemDisplayPageTitleField.ascx。存放在 Local_Drive:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\CONTROLTEMPLATES目录下。
添加下列指向标记到文件中:
<%@ Control Language="C#" %>
<%@ Assembly Name="Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %>
<%@ Register
TagPrefix="mobile" Namespace="System.Web.UI.MobileControls" Assembly="System.Web.Mobile, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" %>
<%@ Register
TagPrefix="SharePoint" Namespace="Microsoft.SharePoint.WebControls" Assembly="Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %>
<%@ Register
TagPrefix="SPMobile" Namespace="Microsoft.SharePoint.MobileControls" Assembly="Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %>
<%@ Import Namespace="Microsoft.SharePoint" %>
然后,在其下面添加一个RenderingTemplate 对象,设置其 ID 为 显示页面所搜索的 SPMobileWebTitle 对象的ID:MobileCustomListField_Announcements_Text_Title。
<SharePoint:RenderingTemplate RunAt="Server" ID="MobileCustomListField_Announcements_Text_Title" >
</SharePoint:RenderingTemplate>
在 RenderingTemplate 元素中,定义一个 Template 元素来包含一个 Label 子控件。设置label的属性如下:
<Template>
<mobile:Label Text="Title field in Announcements List" RunAt="Server" />
</Template>
保存并关闭该文件。
重启Internet Information Services (IIS) 。可以在命令行里使用iisreset命令来重启IIS。
如果您使用的是电脑上的设备模拟器,而不是真正的mobile设备,您可能还需要删除Internet临时文件。
通过您的设备或模拟器导航到某个通知列表。点击一项通知进入其显示页面。您将看到新定制的标题,正如下面的屏幕截图所示: