共用方式為


建立 SharePoint 的應用程式頁面

應用程式頁面是設計用於 SharePoint 網站的 ASP.NET 網頁。 應用程式頁面是一種特殊類型的 ASP.NET 頁面。 應用程式頁面與標準 ASP.NET 頁面之間的主要差異在於,應用程式頁面包含與 SharePoint 主版頁面合併的內容。 主版頁面可讓應用程式頁面與網站上的其他頁面共用相同的外觀和行為。

Visual Studio 可讓您使用設計工具來設計應用程式頁面。 設計師會顯示在主版頁面中定義的每個內容預留位置的內容區域。 您可以將控制項拖曳至這些內容區域,以設計應用程式頁面。

申請頁面

應用程式頁面會在伺服器上的所有網站之間共用,而網站頁面則特定於一個網站。 如需詳細資訊, 請參閱 SharePoint 頁面類型

根據預設,當您建立 SharePoint 網站時,大部分出現的頁面都是網站頁面。 網站頁面可以新增至 SharePoint 頁面文件庫。 使用者可以使用 SharePoint Designer 等工具自訂網站頁面。 網站頁面也可以裝載動態網頁組件和網頁組件區域等功能。

應用程式頁面無法執行這些操作。 不過,如果您想要頁面包含自訂程式碼,應用程式頁面是建立的最佳頁面類型。 雖然您可以將自訂程式碼新增至網站頁面,但當使用者使用 SharePoint Designer 等工具自訂頁面時,程式碼會停止執行。

備註

Visual Studio 不提供範本來協助您建立 SharePoint 網站的網站頁面。 如需詳細資訊,請參閱 SharePoint 頁面類型

建立應用程式頁面

若要建立應用程式頁面,請將 應用程式頁面 項目新增至 SharePoint 專案。 當您建立應用程式頁面時,Visual Studio 會將下列資料夾新增至您的專案:

資料夾 Description
Layouts 對應至 SharePoint 檔案系統的 _layouts 虛擬目錄。
Layouts 子資料夾 包含組成應用程式頁面的檔案。 依預設,此資料夾與您的專案具有相同的名稱。 您可以隨時重新命名此資料夾。 當您執行專案時,Visual Studio 會將此資料夾部署至 SharePoint 檔案系統的_layouts虛擬目錄。

Visual Studio 會將下列檔案新增至您的專案:

檔案 Description
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 網站的 主版頁面庫 中找到它。

您可以設定 MasterPageFile 應用程式 Page 元素的屬性,明確變更應用程式頁面所使用的主版頁面。 (例如: MasterPageFile="~/_layouts/applicationv4.master")。 事實上,如果未在 SharePoint 伺服器上啟用動態主版頁面,您必須設定此屬性。 如需 SharePoint 中主版頁面的詳細資訊,請參閱 主版頁面