HOW TO:匯入主版頁面或佈景主題
主版頁面和佈景主題可為 SharePoint 網站上的頁面提供一致的外觀。 雖然 Visual Studio 不會提供主版頁面或佈景主題的範本,您還是可以在 SharePoint Designer 中建立範本,然後將其匯入 Visual Studio。 本文件示範如何匯入主版頁面和佈景主題。 如需詳細資訊,請參閱 MSDN 網站上的建置組塊:頁面和使用者介面 (英文)。
若要匯入主版頁面或佈景主題
在 Visual Studio 中開啟 SharePoint 專案。
如果您沒有專案,可以建立一個空的 SharePoint 專案。 如需詳細資訊,請參閱 SharePoint 專案與專案項目範本。
在 [方案總管] 中,以滑鼠右鍵按一下專案節點,指向 [加入],然後按一下 [新增項目]。
在 [加入新項目] 對話方塊的 SharePoint 範本清單中,選取 [模組]。 為此模組提供名稱。
模組會當做容器使用,以便將檔案 (如主版頁面或佈景主題檔案) 部署到 SharePoint 中的指定位置。
在此模組中,請刪除預設 Sample.txt 檔。
若要將主版頁面或佈景主題檔案加入至模組中,請選取模組節點,然後按一下 [專案] 功能表上的 [加入現有項目]。 找出主版頁面或佈景主題檔案,並加以選取。 主版頁面檔案的副檔名為 .master,而佈景主題檔案的副檔名為 .thmx。
如果您已加入主版頁面,請將它的 [部署衝突解決] 設定變更為 [自動]。
注意事項 如果主版頁面的名稱與標示為「預設主版頁面」或「自訂主版頁面」的現有主版頁面名稱相同,則會發生錯誤。 如需如何解決此問題的詳細資訊,請參閱逐步解說:匯入自訂主版頁面及包含影像的網站頁面。
在模組中,按兩下 Elements.xml,即可於編輯器中將它開啟。
您必須更新 Elements.xml 檔案來參考您所加入的主版頁面或佈景主題。
如果是主版頁面,請使用下列標記取代現有的模組標記。
<Module Name="[Module Name]" Url="_catalogs/masterpage"> <File Path="[Module Name]\[Master Page Name].master" Url="[Master Page Name].master" Type="GhostableInLibrary" /> </Module>
如果是佈景主題,請使用下列標記取代現有的模組標記。
<Module Name="[Module Name]" Url="_catalogs/theme" <File Path="[Module Name]\[Theme Name].thmx" Url="[Theme Name].thmx" Type="GhostableInLibrary" /> </Module>
請務必使用模組和主版頁面或佈景主題的實際名稱來取代預留位置值。
Type="GhostableInLibrary" 屬性表示此項目加入至內容資料庫,而且模組的 Url 屬性會指定要將檔案儲存在 SharePoint 內容資料庫中的哪一個位置。
若要變更主版頁面的部署範圍,請在 [方案總管] 中按兩下此功能檔案,即可在功能設計工具中檢視它。
按一下 [範圍] 方塊,指定主版頁面的範圍。
[Web] 值表示主版頁面只會套用到目前在專案中指定的網站。 [網站] 值表示主版頁面會套用到目前的網站集合,其中包括所有子網站和根網站。 其他的值則不適用。
注意事項 因為佈景主題只適用於網站集合層級,所以我們建議您不要將佈景主題的範圍設定為 [網站] 以外的任何值。 如果在子網站中使用佈景主題,可能會發生錯誤。
在 [建置] 功能表上,按一下 [部署方案]。
若要確認檔案已正確部署,請開啟 SharePoint 網站。
在 SharePoint 中的 [網站動作] 索引標籤上,按一下 [網站設定]。
如果您已加入主版頁面,請在 [網站設定] 頁面上按一下 [主版頁面],檢視主版頁面的清單。 如果您已加入佈景主題,請在 [網站設定] 頁面上按一下 [佈景主題],檢視佈景主題的清單。 匯入的主版頁面或佈景主題應該會出現在清單中。