建立 SharePoint 的 Web 組件

使用瀏覽器，使用 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 會在您的專案中建立資料夾並在其中加入檔案加入至資料夾。下表將針對各個檔案進行說明。

如需詳細資訊，請參閱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 網站並使用清單頁面。

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 組件的逐步解說。

相關主題