Vytvoření ovládacích prvků, opakovaně použitelných webových částí nebo aplikace stránek

Článek
05/01/2013

V aplikaci Visual Studio můžete vytvořit vlastní, opakovaně použitelné ovládací prvky, které mohou být spotřebovány stránky aplikací a webových částí, které jsou spuštěny ve službě SharePoint.Tyto ovládací prvky nazývají uživatelské ovládací prvky.Další informace o uživatelských ovládacích prvcích naleznete v tématu ASP.NET User Controls.

Vytvoření uživatelského ovládacího prvku

Vytvořit uživatelský ovládací prvek, přidejte Uživatelský ovládací prvek se Prázdný projekt SharePoint.Další informace naleznete v tématu Jak: stránky aplikace SharePoint nebo webová část vytvořit ovládací prvek uživatele.

Při přidání Uživatelský ovládací prvek zboží, Visual Studio vytvoří složku projektu a potom přidá několik souborů do složky.Následující tabulka popisuje každý soubor.

Soubor	Description
Soubor uživatelského ovládacího prvku	Definuje uživatelský ovládací prvek.Uživatelský ovládací prvek návrhu přidáním ovládacích prvků a značek do tohoto souboru.
Soubor kódu	Obsahuje kód uživatelského ovládacího prvku.Přidáte kód pro zpracování události tohoto souboru.
Soubor kódu návrháře	Obsahuje kód generovaný návrháře a neměli upravovat přímo.

Uživatelský ovládací prvek návrhu

Návrh uživatelského ovládacího prvku pomocí návrháře aplikace Visual Web Developer v sadě Visual Studio.Tento návrhář zobrazí při otevření souboru uživatelského ovládacího prvku v projektu a zvolte Návrh kartu.Další informace o použití tohoto Návrhář viz Visual Studio 11 Beta obsahu mapy webu.

Využívající uživatelský ovládací prvek.

Uživatelské ovládací prvky se nezobrazí ve službě SharePoint, dokud zahrnutí stránku aplikace nebo webové části.

Zahrnutí uživatelského ovládacího prvku na stránce aplikace přidat @ Register směrnice stránky aplikace a pak prohlásit uživatelský ovládací prvek uvnitř jednoho nebo více symboly obsahu na stránce.Příklad dosáhnout standardní stránce technologie ASP.NET, naleznete v How to: Include a User Control in an ASP.NET Web Page.

Zahrnout webové části uživatelský ovládací prvek, přidejte uživatelský ovládací prvek webové části Controls kolekce v souboru kódu webové části.Následující příklad přidá uživatelského ovládacího prvku Controls kolekce webových částí.

<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);
    }

}

Ladění uživatelského ovládacího prvku

Ladění uživatelského ovládacího prvku, zajistit, že uživatelský ovládací prvek je součástí stránky aplikace nebo webové části projektu služby SharePoint.Potom můžete ladit kód v uživatelském ovládacím prvku stejně, jako by ladění kódu v jakémkoli projektu Visual Studio.

Když spustíte ladicí program Visual Studio, Visual Studio otevře web služby SharePoint.

Ve službě SharePoint otevřete stránku aplikace, která obsahuje uživatelský ovládací prvek.Pokud je uživatelský ovládací prvek webové části, přidáte webové části na stránku webové části služby SharePoint.

Další informace o ladění projekty SharePoint naleznete v Řešení problémů služby SharePoint.

Příbuzná témata

Title	Description
Jak: stránky aplikace SharePoint nebo webová část vytvořit ovládací prvek uživatele	Ukazuje, jak vytvořit vlastní, opakovaně použitelné ovládací prvky, které mohou být spotřebovány stránky aplikací a webových částí, které jsou spuštěny ve službě SharePoint.
Práce s Visual Web Developer	Popisuje způsob použití návrháře, který se zobrazí při otevření webové stránky v projektu.

Sdílet prostřednictvím