開發 SharePoint 方案
Visual Studio 提供多種 SharePoint 專案類型範本,可供建立 SharePoint 網站和網站項目。 如需可用專案類型的清單,請參閱 SharePoint 專案與專案項目範本。 以下將描述 SharePoint 專案的項目和屬性。
SharePoint 專案的項目
SharePoint 專案底下的節點稱為「SharePoint 項目」(SharePoint Item)。 SharePoint 項目還可能包含一個或多個子檔案,這些檔案稱為「SharePoint 項目檔案」(SharePoint Item File),例如 XML 組態檔、.aspx 表單等。
除了使用已填入專案項目檔案的專案範本建立專案,您也可以使用 [空專案] 範本來建立空的 SharePoint 專案,然後手動新增專案項目。 SharePoint 專案也可選擇性地包含一個或多個功能檔案 (以在 SharePoint 中啟用) 以及一個用來散發專案的封裝檔案。
特殊節點
每個 SharePoint 專案都包含兩個無法重新命名、刪除、剪下、複製或從專案拖曳的節點。 這些節點如下:
功能
封裝
即使專案沒有定義功能或封裝,這兩個節點一律會出現在所有 SharePoint 專案中。
功能節點
[功能] 節點包含一項或多項 SharePoint 專案功能。 功能是 SharePoint 擴充的容器。 將功能部署到 SharePoint 伺服器之後,便可以將它包含在網站定義中,或由 SharePoint 系統管理員在 SharePoint 網站上個別啟動。 如需詳細資訊,請參閱使用功能 (英文)。
當您將內容類型或清單執行個體等項目加入至 SharePoint 專案時,項目會加入至 [功能] 節點中的功能。 項目的範圍會決定項目要加入至新的還是現有的功能。 如果新項目的範圍與現有功能相同,這個項目就會加入至該功能。 否則,項目會加入至新功能。
若要手動加入功能,請執行功能節點之捷徑功能表上的 [加入功能] 命令。 您可以使用「功能設計工具」檢視或變更功能的內容。 如需詳細資訊,請參閱 HOW TO:自訂 SharePoint 功能。
將功能加入至 SharePoint 專案時,它會以節點的形式出現在 [方案總管] 中,預設名稱為 Featurex.feature,其中 x 是唯一號碼。 將功能部署到 SharePoint 伺服器之後,SharePoint 系統管理員便可以啟動它,以供 SharePoint 網站使用者使用。
封裝節點
[封裝] 節點包含單一檔案,此檔案可做為 SharePoint 專案的散發機制。 此檔案稱為「方案封裝」(Solution Package),以 .CAB 為基礎且具有 .WSP 副檔名。 方案套件是可部署和可重複使用的檔案,其中包含適用於 SharePoint 網站的一組功能、網站定義和組件,您可以個別加以啟用或停用。 [封裝] 節點也一律包含名為 Package.wspdef 的檔案,這是封裝的 XML 定義檔。 一旦將封裝部署到 SharePoint 伺服器,SharePoint 系統管理員就可以安裝它並啟動其功能。
按兩下 [封裝] 節點可在 [封裝設計工具] 中開啟節點。 您接著可以檢視或變更其內容。 如需詳細資訊,請參閱建立 SharePoint 方案套件。
SharePoint 專案與專案項目屬性
如同其他 Visual Studio 專案,SharePoint 專案會在 [屬性] 視窗和 [屬性頁] 顯示屬性。 顯示的屬性需視選取的節點而定。
當您在 [方案總管] 中選取 SharePoint 專案、專案項目或專案項目檔案節點時,下列屬性會出現在 [屬性] 視窗或 [屬性頁面] 中:
專案屬性
屬性名稱 |
說明 |
---|---|
現用部署組態 |
指定部署期間執行的一系列的步驟。 如需詳細資訊,請參閱 HOW TO:編輯 SharePoint 部署組態。 |
組件部署目標 |
決定「SharePoint 應用程式組件」(SharePoint Application Assembly) 所在的位置。 有效的組件位置值為 GlobalAssemblyCache (預設值) 或 WebApplication。 如果 Sandboxed Solution 屬性設定為 true,則會停用此屬性。 |
偵錯後自動撤銷 |
指定在 Visual Studio 中以偵錯模式執行應用程式後,是否自動從 SharePoint 撤銷已部署的方案。 如果選取此選項,當 IDE 在偵錯後恢復為設計檢視時,方案即會撤銷。 如果清除此選項,方案將不會撤銷。 如需詳細資訊,請參閱解除安裝及撤銷陣列方案 (英文)。 |
編輯組態 |
指定要用於專案的部署組態。 如需詳細資訊,請參閱 HOW TO:編輯 SharePoint 部署組態和部署 SharePoint 方案套件。 |
啟用 Silverlight 偵錯 (而不是 Script 偵錯) |
選取此選項時,Silverlight 偵錯工具會附加至偵錯流程。 清除此選項時,Script 偵錯工具會附加至偵錯流程。 如需詳細資訊,請參閱 Silverlight 偵錯概觀 (英文)。 |
在封裝中包含組件 |
指定建置階段是否要封裝專案組件。 |
部署後命令列 |
指定在部署 SharePoint 方案後所要執行的命令。 這個命令列可支援任何批次命令以及 MSBuild 變數解析。 如需詳細資訊,請參閱 HOW TO:設定 SharePoint 部署命令。 |
預先部署命令列 |
指定在部署 SharePoint 方案前所要執行的命令。 這個命令列可支援任何批次命令以及 MSBuild 變數解析。 如需詳細資訊,請參閱 HOW TO:設定 SharePoint 部署命令。 |
專案檔 |
包含組建、組態和其他與專案相關資訊之檔案的名稱。 |
專案資料夾 |
專案檔在系統上的位置 (唯讀)。 |
沙箱化方案 |
指定是否應將專案部署為「沙箱化方案」(Sandboxed Solution),亦稱為「使用者建立的方案」(User-created Solution)。 沙箱化方案不一定可信任。 true 值表示專案將部署為沙箱化方案,false 值則表示專案將部署為陣列方案。 如需詳細資訊,請參閱沙箱化方案考量和沙箱化方案與伺服器陣列方案之間的差異。 |
網站 URL |
指定此專案的目標網站 URL。 |
啟動項目 |
指定專案中第一個執行的項目。 |
當您選取 SharePoint 項目檔案 (例如工作流程或 [功能] 節點中的功能) 時,下列屬性會出現在 [屬性] 視窗中:
專案項目屬性
屬性名稱 |
說明 |
---|---|
部署衝突解決方式 |
指定在部署專案項目時,如果其屬性與伺服器中已存在項目相同時要採取的動作。 如需詳細資訊,請參閱SharePoint 封裝和部署疑難排解。 |
功能屬性 |
指定將功能部署至 SharePoint 時功能中所含的一組值 (儲存為索引鍵/值組)。 部署功能之後,您便可以存取程式碼中的屬性值。 如需詳細資訊,請參閱提供專案項目中的封裝和部署資訊。 |
功能接收器 |
提供專案項目所含功能發生特定事件時執行的程式碼。 如需詳細資訊,請參閱提供專案項目中的封裝和部署資訊。 |
資料夾名稱 |
SharePoint 專案項目資料夾的名稱。 |
專案輸出參考 |
指定專案項目需要執行的相依性,例如組件。 如需詳細資訊,請參閱提供專案項目中的封裝和部署資訊。 |
安全控制項項目 |
指定可供未受信任的使用者編輯而沒有安全顧慮的控制項。 如需詳細資訊,請參閱提供專案項目中的封裝和部署資訊。 |
專案項目檔案屬性
屬性名稱 |
說明 |
---|---|
建置動作 |
指定檔案與建置和部署程序關聯的方式。 如需詳細資訊,請參閱 檔案屬性。 |
複製到輸出目錄 |
指定是否要將原始程式檔複製到輸出目錄。 可以是下列其中一個值:
如需詳細資訊,請參閱 檔案屬性。 |
自訂工具 |
指定在設計階段轉換檔案並將轉換輸出放置到另一個檔案的工具名稱 (如果有)。 例如,資料集 (.XSD) 檔案具有預設自訂工具。如需詳細資訊,請參閱檔案屬性。 |
自訂工具命名空間 |
自訂工具輸出複製到其中的命名空間。 如需詳細資訊,請參閱 檔案屬性。 |
部署位置 |
SharePoint 伺服器上檔案的完整路徑。 此路徑是由 [部署根目錄] 和 [部署路徑] 子屬性組成。 |
部署路徑 |
檔案在 SharePoint 伺服器上的相對路徑,例如 Workflow1\。 建立檔案完整路徑的方式是將 Deployment Path 值串連到 Deployment Root 值的結尾。 將 Deployment Type 屬性設定為 RootFile 時,會將 Deployment Root 屬性變更為 {SharePointRoot}\,產生 {SharePointRoot}\Workflow1\ 的完整路徑。 如需詳細資訊,請參閱封裝和部署 SharePoint 方案。 |
部署根目錄 |
字串。 SharePoint 伺服器上用來部署檔案的根資料夾。 例如 {SharePointRoot}\Template\Features\{FeatureName}\。 Deployment Root 屬性的值由 Deployment Type 設定決定。 |
部署類型 |
檔案的部署類型,由其 Deployment Root 值決定。 可以是下列其中一個值:
列舉值 Deployment Root 值
NoDeployment<沒有值>
ElementManifest{SharePointRoot}\Template\Features\{FeatureName}\
ElementFile{SharePointRoot}\Template\Features\{FeatureName}\
TemplateFile{SharePointRoot}\Template\
RootFile{SharePointRoot}\
GlobalResource{SharePointRoot}\Resources\
ClassResource{ClassResourcePath}\
如需詳細資訊,請參閱 DeploymentType。 |
檔案名稱 |
項目檔案的檔案或資料夾名稱。 |
完整路徑 |
項目的檔案位置。 (唯讀)。 |
相關主題
標題 |
說明 |
---|---|
說明 Visual Studio 中可供使用的 SharePoint 專案和專案項目範本。 |
|
說明如何將新的或現有的項目加入至 Visual Studio SharePoint 專案。 |
|
引導您逐步建立自訂欄位、內容類型、清單定義和清單執行個體。 |
|
說明如何為逐步解說:建立自訂欄位、內容類型、清單定義及清單執行個體中建立的專案加入事件接收器。 |
|
說明如何建立包含工作流程關聯表單和工作流程初始表單的工作流程專案。 |
|
說明如何為 SharePoint 建立頁面,例如應用程式頁面、網站頁面、主版頁面和頁面配置。 |
|
說明如何加入控制項,以讓使用者使用瀏覽器,直接修改 SharePoint 網站頁面的內容、外觀及行為。 |
|
說明如何建立使用者控制項,即可由 SharePoint 中執行的應用程式頁面和 Web 組件使用的控制項。 |
|
說明如何將 Web 服務和後端伺服器應用程式的資料整合到 SharePoint 應用程式中。 |
|
說明如何建立網站定義,即用來建立 SharePoint 網站的範本。 |
|
說明如何將內容類型和模組等項目從現有的 SharePoint 網站匯入 Visual Studio SharePoint 專案中。 |
|
說明如何使用模組,將檔案從 Visual Studio 專案部署至 SharePoint 網站。 |
|
說明如何使用伺服器總管瀏覽本機 SharePoint 網站。 |
|
說明如何使用專案項目屬性來提供專案的封裝和部署資訊,例如安全控制項項目、專案輸出參考和功能屬性。 |
|
說明如何將對應資料夾加入至您的專案,讓存取 SharePoint 資源更為容易。 |
|
說明與沙箱化方案相關的問題。 |
|
說明在 Visual Studio 中開發 SharePoint 方案的安全性考量。 |
|
描述您可用來在專案或本機 SharePoint 伺服器上加入資源路徑參考的對話方塊。 |