WSS 3.0 SDK 實戰演練：定制 Mobile 列表視圖頁內容區——以 RenderingTemplate 注入問候訊息

演練目標

示範如何透過自訂 RenderingTemplate 覆寫 Mobile 列表視圖頁（主頁）的**內容區**，在公告列表上方加入問候訊息。

Mobile 列表視圖渲染機制

SPMobileListContents 選擇器依列表類型搜尋 ID 為 Mobile_{ListTypeID}_View_Contents 的模板。找不到時回退 Mobile_Default_View_Contents。WSS 內建無 Mobile_Announcements_View_Contents（或 Mobile_104_View_Contents），故可自行建立。

建立 AnnouncementsViewPageContents.ascx

1. 建立 UTF-8 文字檔，命名 AnnouncementsViewPageContents.ascx，置於 CONTROLTEMPLATES 目錄。
2. 加入指示詞與命名空間註冊（同前）。
3. 定義 RenderingTemplate，ID 為 Mobile_104_View_Contents：

   <SharePoint:RenderingTemplate ID="Mobile_104_View_Contents" RunAt="Server">
     <Template>
       <SPMobile:SPMobileControlContainer RunAt="Server">
         <SPMobile:SPMobileComponent RunAt="Server" TemplateName="MobileViewPicker" />
         <SPMobile:SPMobileComponent RunAt="Server" TemplateName="MobileDefaultSeparator" />
       </SPMobile:SPMobileControlContainer>
       <mobile:Label RunAt="Server" Text="Hello SharePoint Mobile User!" />
       <SPMobile:SPMobileListItemIterator
         RunAt="Server"
         ListItemSeparatorTemplateName="MobileListItemSeparator" />
     </Template>
   </SharePoint:RenderingTemplate>

   • SPMobileControlContainer：容器控制項。
   • SPMobileComponent TemplateName="MobileViewPicker"：內建視圖切換器。
   • SPMobileComponent TemplateName="MobileDefaultSeparator"：內建分隔線。
   • mobile:Label：自訂問候訊息（核心新增內容）。
   • SPMobileListItemIterator：列表項迭代渲染器，ListItemSeparatorTemplateName 指定項間分隔模板。
4. 儲存，iisreset，清除模擬器暫存。

驗證結果

以 Mobile 裝置瀏覽公告列表，列表上方將顯示 **「Hello SharePoint Mobile User!」** 問候訊息。

關鍵觀念

• 視圖頁三區塊（標題/內容/導航）分別由 SPMobileListTitle、SPMobileListContents、SPMobileListNavigation 選擇器控制。
• 內容區模板 ID 格式：Mobile_{ListTypeID}_View_Contents。
• 使用 SPMobileComponent 內嵌預設子模板（MobileViewPicker、MobileDefaultSeparator），保留原功能並注入新內容。
• SPMobileListItemIterator 為列表項渲染核心，不可省略。