WSS 3.0 SDK 技術詳解：如何定制 Mobile 頁面中的欄位渲染——RenderingTemplate 機制與部署全攻略

Mobile 欄位渲染定制流程概覽

Mobile 頁面透過 SPMobileListFieldSelector 發起鏈式調用，依目前列表類型與欄位決定套用的 RenderingTemplate。開發者可透過部署同 ID 的自訂模板覆寫預設渲染。

RenderingTemplate ID 命名規則與解析邏輯

搜尋 ID 格式：MobileCustomListField_{ListTypeID}_{FieldType}_{Field}

重要：若欄位顯示名稱含空格/標點，系統產生的內部名稱將包含編碼字元（如 _x0020_），導致 ID 無法匹配，**此類欄位無法透過此機制定制渲染**。

內建 RenderingTemplate 清單

WSS 安裝後預載於 MobileDefaultTemplates.ascx：

• MobileCustomListField_Contacts_Text_WorkPhone
• MobileCustomListField_Contacts_Text_HomePhone
• MobileCustomListField_Contacts_Text_CellPhone
• MobileCustomListField_Contacts_Text_Email
• MobileCustomListField_PictureLibrary_Computed_ImageSize
• MobileCustomListField_Posts_DateTime_PublishedDate

勿修改 MobileDefaultTemplates.ascx。可建立同 ID 新模板覆寫，但有風險：可能破壞相依原模板的其他方案。載入順序：內建 → 自訂（字母序後者勝出），同檔案重複 ID 皆不載入。

定制步驟標準化流程

1. 建立 .ascx 使用者控制項檔，置於 \12\TEMPLATE\CONTROLTEMPLATES。
2. 加入頁面指示詞註冊必要命名空間（mobile、SharePoint、SPMobile）。
3. 宣告 <SharePoint:RenderingTemplate>，ID 依命名規則設定。
4. <Template> 內直接放置可渲染控制項（如 <mobile:Label>），或參考繼承 SPMobileBaseFieldControl 的自訂控制項標籤。
5. 儲存檔案，執行 iisreset 生效。

範例：公告列表 Title 欄位自訂渲染

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

進階：巢狀 RenderingTemplate

可在 <Template> 內參考其他 RenderingTemplate（透過 SPMobileComponent）：

<SharePoint:RenderingTemplate ID="Mobile_104_View_Navigation" RunAt="Server">
  <Template>
    <mobile:Link Text="ASP.NET Website" NavigateUrl="https://www.asp.net" RunAt="Server" />
    <mobile:Label RunAt="Server" Text="" BreakAfter="True" />
    <SPMobile:SPMobileComponent RunAt="Server" TemplateName="Mobile_Default_View_Navigation" />
  </Template>
</SharePoint:RenderingTemplate>

此技巧可組合預設渲染與自訂內容，保留原有導航列同時加入新連結。

1. 上一篇文章： WSS 3.0 SDK 實戰演練：在 Mobile 顯示表單定制列表項標題——以 RenderingTemplate 覆寫預設渲染
2. 下一篇文章： WSS 3.0 SDK 實戰演練：定制 Mobile 列表視圖頁內容區——以 RenderingTemplate 注入問候訊息

關於.NET

WF 追蹤服務深度解析：架構、設定檔、SQL 服務與自訂實作

前言 Windows Workflow Foundation

WPF 多點觸控開發：進階操作

Manipulation 事件總覽 WPF 4 內建高階觸控

NHibernate實戰（3）：HQL 查詢語言基礎與參數化最佳實踐

前言 NHibernate 查詢語言 (HQL) 是面向對象

WinForms 介面開發 (三)：設定視窗 Region 實現圓角視窗與非矩形佈局

系列第三篇：在攔截視窗訊息 (Hook) 與 NativeW