WSS3SDK之：演練–在mobile的顯示表單中定製清單項目標題

本次演練中將向大家展示如何通過實現一個自訂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。在本次演練中，您將建立一個新的用於通知清單的清單項目標題欄位的模板，來替換預設範本。

定製通知項的標題：

1. 在文字編輯器中，建立一個文字檔 (UTF-8)，命名為AnnouncementsItemDisplayPageTitleField.ascx。存放在 Local_Drive:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\CONTROLTEMPLATES目錄下。

2. 添加下列指向標記到檔案中：

   <%@ 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" %>

3. 然後，在其下面添加一個RenderingTemplate 對象，設定其 ID 為 顯示頁面所搜尋的 SPMobileWebTitle 對象的ID：MobileCustomListField_Announcements_Text_Title。

   <SharePoint:RenderingTemplate RunAt="Server" ID="MobileCustomListField_Announcements_Text_Title" >
   </SharePoint:RenderingTemplate>

4. 在 RenderingTemplate 元素中，定義一個 Template 元素來包含一個 Label 子控制項。設定label的屬性如下：

   <Template>
     <mobile:Label Text="Title field in Announcements List" RunAt="Server" />
   </Template>

5. 儲存並關閉該檔案。

6. 重啟Internet Information Services (IIS) 。可以在命令列裡使用iisreset命令來重啟IIS。

7. 如果您使用的是電腦上的裝置模擬器，而不是真正的mobile裝置，您可能還需要刪除Internet臨時檔案。

8. 通過您的裝置或模擬器導航到某個通知清單。點擊一項通知進入其顯示頁面。您將看到新定製的標題，正如下面的螢幕所示：