建立 SharePoint 的 Web 組件

發行項
05/01/2013

使用瀏覽器，使用 Web 組件，使用者可以直接修改 SharePoint 網站頁面的內容、外觀和行為。Web 組件是在呼叫 Web 組件頁面的網頁內特定類型的伺服器端控制項:它們是出現在 SharePoint 網站頁面的建置組塊。如需在 SharePoint 的 Web 組件的詳細資訊，請建置組塊:Web 組件參閱。

Visual Studio 提供可用來建立和偵錯在 SharePoint 網站的 Web 組件的範本。

在 Visual Studio 中建立 Web 組件

將 [網頁組件] 項目建立 Web 組件加入至任何 SharePoint 專案。您可以使用沙箱化方案或陣列方案中的 [網頁組件] 項目。

若要使用設計工具，如果您要以視覺化方式設計 Web 組件，建立 [視覺 Web 組件] 專案或加入 [視覺 Web 組件] 項目加入至任何 SharePoint 專案。在一個陣列方案中，您只能使用一個 [視覺 Web 組件] 項目。

Web 組件項目

[網頁組件] 項目提供可讓您設計 SharePoint 網站中的 Web 組件的檔案。當您將 [網頁組件] 項目時， Visual Studio 會在您的專案中建立資料夾並在其中加入檔案加入至資料夾。下表將針對各個檔案進行說明。

檔案	描述
Elements.xml	包含在專案中功能定義檔使用部署 Web 組件的資訊。
.webpart 檔	提供 SharePoint 需要顯示 [Web 組件庫中的 Web 組件的資訊。
程式碼檔	包含將控制項加入至 Web 組件，並且在 Web 組件中的自訂內容的方法。

如需詳細資訊，請參閱HOW TO：建立 SharePoint Web 組件。

視覺 Web 組件項目

"視覺 Web 組件是使用 Visual Studio 中， Visual Web Developer 設計工具建立的 Web 組件。如需如何使用此設計工具的詳細資訊，請參閱 Visual Studio Web 程式開發環境內容對應。

功能上，控制項的視覺 Web 組件與 Web 組件不同。[視覺 Web 組件] 項目包含 [Web 組件] 項目和 [使用者控制項] 項目。

您可以拖曳或複製 Visual Studio [工具箱] 的控制項設計 Web 組件的外觀到使用者控制項的介面。如需詳細資訊，請參閱HOW TO：使用設計工具建立 SharePoint Web 組件。

SharePoint 控制項

Visual Studio 提供建立 SharePoint 頁面提供某些控制項，例如應用程式頁面。這些控制項會出現在工具箱中 [SharePoint 控制項] 下。這些控制項的功能從 Microsoft.SharePoint.WebControls 命名空間，以包含 ASP.NET 伺服器控制項在 SharePoint 網站並使用清單頁面。

控制項名稱	描述
AspMenu	插入 ASP 功能表。如需詳細資訊，請參閱功能表控制項概觀。
CssLink	CssRegistration插入至 .aspx 網頁及套用一個或多個外部樣式表中定義的 LINK 項目。
DateTimeControl	插入 DateTime 控制項的 .aspx 網頁。
FormDigest	插入安全性驗證輸入 .aspx 網頁
ListProperty	傳回指定的清單中的屬性。
ProjectProperty	傳回目前網站的全域屬性。
RssLink	插入連結至 RSS 饋送到 .aspx 網頁。
ScriptLink	為註冊資源提供屬性和方法，例如指令碼，在網頁，以便要求，呈現網頁時。
主題	將主題套用至 .aspx 網頁。

Web 組件偵錯

您可以偵錯包含一個 Web 組件的 SharePoint 專案就像偵錯其他 Visual Studio 專案。當您啟動 Visual Studio 偵錯工具時，Visual Studio 就會開啟 SharePoint 網站。

若要開始偵錯程式碼，請將網頁組件加入至 SharePoint 的 Web 組件頁面。

如需如何偵錯 SharePoint 專案的詳細資訊，請參閱SharePoint 方案疑難排解。

視覺 Web 組件限制

從 Visual Studio 中，您可以將視覺 Web 組件加入至 SharePoint 沙箱化方案與陣列方案。不過，視覺 Web 組件有下列限制:

視覺 Web 組件不支援可取代的參數。如需詳細資訊，請參閱可置換的參數。
使用者控制項或視覺 Web 組件無法被拖放或複製到視覺 Web 組件上。這個動作會導致建置錯誤。
視覺 Web 組件不直接支援 SharePoint Server 語彙基元 (例如$SPUrl。如需詳細資訊，請參閱<權杖限制沙箱化視覺 Web 組件」主題中的 SharePoint 方案疑難排解。
在沙箱化方案中的視覺 Web 組件偶爾發生錯誤，「沙箱化程式碼執行要求被拒絕，因為沙箱化程式碼主機服務太忙碌而無法處理要求」。如需此錯誤的詳細資訊，請參閱 MSDN Library 的 SharePoint 開發人員團隊部落格這篇文章。
伺服器端 JavaScript 偵錯 Visual Studio 不支援，不過，用戶端 JavaScript 偵錯支援。

雖然您可以將內嵌 JavaScript 到伺服器端標記檔案，偵錯沒有中斷點支援加入至標記。若要偵錯 JavaScript，請參考標記檔案中外部 JavaScript 檔案，然後在 JavaScript 檔案的中斷點。
內嵌 ASP.NET 程式碼偵錯在產生的程式碼檔案必須完成而不是在標記檔案。
視覺 Web 組件不支援使用 <@ Assembly Src= 指示詞。
SharePoint Web 控制項和一些 ASP.NET 控制在 SharePoint 部署環境不支援。如果不支援的控制項在控制項的視覺 Web 組件上使用沙箱化方案，錯誤，「型別或命名空間名稱"主題」不存在於命名空間「Microsoft.SharePoint.WebControls」」外觀。

如需沙箱化方案的詳細資訊，請參閱沙箱化方案與伺服器陣列方案之間的差異。

建立舊樣式 SharePoint 架構的 Web 組件

您可以使用 Visual Studio 範本建立 SharePoint 的自訂 ASP.NET 2.0 Web 組件。ASP.NET 2.0 Web 組件建置在 ASP.NET Web 組件基礎結構頂端是新專案的建議的型別。

使用舊樣式 SharePoint 架構的 Web 組件，在少數情況下，您可能必須建立 Web 組件。您可以使用 Visual Studio 建立 Web 組件類型，不過， Visual Studio 並不提供專門設計來協助您建立它們的任何樣板。

如需的相關資訊，您可能想要建立舊樣式 SharePoint 架構的 Web 組件，請參閱網路在 Windows SharePoint Services 的部分基礎結構。使用舊樣式 SharePoint 架構的 Web 組件，如需如何建立 Web 組件的詳細資訊，請參閱建立基本 SharePoint Web 組件的逐步解說。

標題	描述
HOW TO：建立 SharePoint Web 組件	示範如何建立 SharePoint 頁面的 Web 組件。
HOW TO：使用設計工具建立 SharePoint Web 組件	使用視覺化設計介面，顯示如何建立 SharePoint 的 Web 組件。
HOW TO：為 SharePoint 應用程式頁面或 Web 組件建立使用者控制項	示範如何建立自訂，可以由應用程式頁面和 Web 組件使用、可重複使用的控制項。
逐步解說：建立 SharePoint 的 Web 組件	說明如何設計 SharePoint 中的 Web 組件。
逐步解說：使用設計工具建立 SharePoint 的 Web 組件	說明如何將控制項拖曳到設計 SharePoint 中的 Web 組件加入至視覺化設計介面。
逐步解說：建立可顯示 SharePoint 之 OData 的 Silverlight Web 組件	說明如何設計裝載 Silverlight 應用程式並顯示從 SharePoint 清單資料的 SharePoint 中的 Web 組件。
使用 Visual Web Developer	描述如何使用出現的設計工具會在您開啟專案中的一個 Web 網頁。

共用方式為