為 Web 組件或應用程式頁面建立可重複使用的控制項

在 Visual Studio 中，您可以建立自訂，可以由應用程式頁面和 Web 組件使用在、可重複使用的控制項。這些控制項被稱為使用者控制項 (User Control)。如需使用者控制項的詳細資訊，請參閱ASP.NET User Controls。

建立使用者控制項

若要建立使用者控制項，請將 [使用者控制項] 加入至 [空的 SharePoint 專案]。如需詳細資訊，請參閱HOW TO：為 SharePoint 應用程式頁面或 Web 組件建立使用者控制項。

加入 [使用者控制項] 項目時，Visual Studio 會在您的專案中建立一個資料夾，然後在其中加入數個檔案。下表將針對各個檔案進行說明。

設計使用者控制項

您可以使用 Visual Studio 中的 Visual Web Developer 設計工具，設計使用者控制項。這個設計工具會在您開啟專案中的使用者控制項檔案並選取 [設計] 索引標籤。如需使用這個設計工具的詳細資訊，請參閱Visual Studio Web 程式開發環境內容對應。

運用使用者控制項

在您將使用者控制項納入應用程式頁面或 Web 組件之前，這些控制項並不會出現在 SharePoint 中。

若要在應用程式頁面中包含使用者控制項，請將 @ Register 指示詞加入至應用程式頁面，然後在頁面上的一個或多個內容預留位置內宣告此使用者控制項。如需如何在標準 ASP.NET 網頁上完成此工作的範例，請參閱 How to: Include a User Control in an ASP.NET Web Page。

若要在 Web 組件中納入使用者控制項，請將使用者控制項加入至 Web 組件程式碼檔案中的 Web 組件 Controls 集合。下列範例會將使用者控制項加入至 Web 組件的 Controls 集合。

<ToolboxItemAttribute(false)> _
Public Class VisualWebPart1
    Inherits WebPart

    Private Const _ascxPath As String = "~/_CONTROLTEMPLATES/VB/VisualWebPart1/VisualWebPart1UserControl.ascx"

    Public Sub New()
    End Sub

    Protected Overrides Sub CreateChildControls()
        Dim control As Control = Page.LoadControl(_ascxPath)
        Controls.Add(control)
        MyBase.CreateChildControls()
    End Sub

    Protected Overrides Sub RenderContents(ByVal writer As HtmlTextWriter)
        MyBase.RenderContents(writer)
    End Sub

End Class

[ToolboxItemAttribute(false)]
public class VisualWebPart1 : WebPart
{
    private const string _ascxPath = @"~/_CONTROLTEMPLATES/CS/VisualWebPart1/VisualWebPart1UserControl.ascx";

    public VisualWebPart1()
    {
    }

    protected override void CreateChildControls()
    {
        Control control = this.Page.LoadControl(_ascxPath);
        Controls.Add(control);
        base.CreateChildControls();
    }

    protected override void RenderContents(HtmlTextWriter writer)
    {
        base.RenderContents(writer);
    }

}

偵錯使用者控制項

若要偵錯使用者控制項，請確認使用者控制項已納入 SharePoint 專案中的應用程式頁面或 Web 組件中。接著，您就能偵錯使用者控制項中的程式碼，其方式就像偵錯任何 Visual Studio 專案中的程式碼一樣。

當您啟動 Visual Studio 偵錯工具時，Visual Studio 就會開啟 SharePoint 網站。

在 SharePoint 中，開啟包含使用者控制項的應用程式頁面。如果使用者控制項包含在 Web 組件中，請將該 Web 組件加入至 SharePoint 中的 [網頁組件頁面]。

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

相關主題