建立 SharePoint 的應用程式頁面
[應用程式頁面] 是專為在 SharePoint 網站中使用所設計的 ASP.NET 網頁。 應用程式頁面是特殊類型的 ASP.NET 網頁。 應用程式頁面與標準 ASP.NET 網頁之間的主要差異在於應用程式頁面包含與 SharePoint 主版頁面合併的內容。 主版頁面可讓應用程式頁面與網站上的其他頁面共用相同的外觀和行為。
Visual Studio 可讓您使用設計工具設計應用程式頁面。 設計工具會顯示主版頁面中定義之每個內容預留位置的內容區域。 您可以將控制項拖曳至這些內容區域,以設計應用程式頁面。
應用程式頁面
應用程式頁面會跨伺服器上的所有網站共用,而網站頁面則專屬於一個網站。 如需詳細資訊,請參閱 SharePoint 頁面類型。
根據預設,建立 SharePoint 網站時出現的大部分頁面都是網站頁面。 網站頁面可以新增至 SharePoint 頁面程式庫。 使用者可以使用 SharePoint Designer 之類的工具來自訂網站頁面。 網站頁面也可以裝載動態 Web 組件和 Web 組件區域等功能。
應用程式頁面無法執行這些動作。 不過,如果您想要讓頁面包含自訂程式碼,應用程式頁面是建立的最佳頁面類型。 雖然您可以將自訂程式碼新增至網站頁面,但是當使用者使用 SharePoint Designer 之類的工具自訂頁面時,程式碼會停止執行。
注意
Visual Studio 不提供可協助您為 SharePoint 網站建立網站頁面的範本。 如需詳細資訊,請參閱 SharePoint 頁面類型。
建立應用程式頁面
若要建立應用程式頁面,請將 [應用程式頁面] 項目新增至 SharePoint 專案。 當您建立應用程式頁面時,Visual Studio 會將下列資料夾新增至您的專案:
資料夾 | 描述 |
---|---|
版面配置 | 對應至 SharePoint 檔案系統的 _layouts 虛擬目錄。 |
版面配置子資料夾 | 包含組成應用程式頁面的檔案。 根據預設,此資料夾的名稱與專案相同。 您可以隨時重新命名此資料夾。 當您執行專案時,Visual Studio 會將此資料夾部署到 SharePoint 檔案系統的 _layouts 虛擬目錄。 |
Visual Studio 會將下列檔案新增至您的專案:
檔案 | 說明 |
---|---|
ASP.NET 網頁檔案 (.aspx) | 包含定義頁面的 XML 標記。 |
應用程式頁面程式碼檔案 | 包含應用程式頁面背後的程式碼。 將處理事件的程式碼新增至此檔案中。 |
應用程式頁面設計工具程式碼檔案 | 包含設計工具所產生的程式碼。 請勿直接編輯此檔案。 |
設計和偵錯應用程式頁面
在 Visual Studio 中使用設計工具檢視來設計應用程式頁面的內容。 當您開啟專案中的應用程式頁面 (透過按兩下,或是開啟其捷徑功能表後選擇 [開啟]),然後選擇編輯器底部的 [設計] 按鈕時,這個設計工具隨即出現。
注意
您只能在設計工具的 [原始碼] 檢視中設計頁面。 應用程式頁面的設計工具 [設計] 檢視已停用。
您可以偵錯應用程式頁面,就像在 Visual Studio 中偵錯其他 SharePoint 專案項目一樣。 當您啟動 Visual Studio 偵錯工具時,Visual Studio 會開啟 SharePoint 網站。
若要檢視應用程式頁面,您必須以手動方式瀏覽至應用程式頁面的所在位置 (例如:http://Server_Name/_layouts/Project_Name/ApplicationPage1.aspx)。
如需如何對 SharePoint 專案進行偵錯的詳細資訊,請參閱針對 SharePoint 解決方案進行疑難排解。
選擇主版頁面
根據預設,[應用程式頁面] 項目會參考您用來偵錯專案之網站的主版頁面。 該頁面名為 v4.master,您可以在 SharePoint 網站的 [主版頁面資源庫] 中找到該頁面。
您可以藉由設定應用程式 Page
元素的 MasterPageFile
屬性,明確地變更應用程式頁面所使用的主版頁面。 (例如:MasterPageFile="~/_layouts/applicationv4.master"
)。 事實上,如果 SharePoint 伺服器上未啟用動態主版頁面,您必須設定此屬性。 如需 SharePoint 中主版頁面的詳細資訊,請參閱主版頁面。