Vytváření opakovaně použitelných ovládacích prvků pro webové části nebo stránky aplikací

V sadě Visual Studio můžete vytvářet vlastní a opakovaně použitelné ovládací prvky, které můžou využívat stránky aplikací a Webové části, které běží na SharePointu. Tyto ovládací prvky se nazývají uživatelské ovládací prvky. Uživatelský ovládací prvek je druh složeného ovládacího prvku, který funguje podobně jako webová stránka ASP.NET – do uživatelského ovládacího prvku můžete přidat existující ovládací prvky webového serveru a značky a definovat vlastnosti a metody ovládacího prvku. Pak je můžete vložit do ASP.NET webových stránek, kde fungují jako jednotka.

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

Chcete-li vytvořit uživatelský ovládací prvek, přidejte uživatelský ovládací prvek do prázdného projektu služby SharePoint. Další informace naleznete v tématu Postupy: Vytvoření uživatelského ovládacího prvku pro stránku nebo webovou část aplikace SharePoint.

Když přidáte položku uživatelského ovládacího prvku , Visual Studio vytvoří v projektu složku a pak do této složky přidá několik souborů. Následující tabulka popisuje jednotlivé soubory.

Soubor	Popis
Soubor uživatelského ovládacího prvku	Definuje uživatelský ovládací prvek. Návrh uživatelského ovládacího prvku přidáním ovládacích prvků a revizí do tohoto souboru
Soubor kódu	Obsahuje kód za uživatelským ovládacím prvku. Přidejte kód pro zpracování událostí do tohoto souboru.
Soubor kódu návrháře	Obsahuje kód vygenerovaný návrhářem a neměl by být přímo upravován.

Návrh uživatelského ovládacího prvku

Návrh uživatelského ovládacího prvku pomocí návrháře Visual Web Developer v sadě Visual Studio Tento návrhář se zobrazí, když otevřete soubor uživatelského ovládacího prvku v projektu a zvolíte kartu Návrh .

Využití uživatelského ovládacího prvku

Uživatelské ovládací prvky se v SharePointu nezobrazí, dokud je nezahrnete na stránku aplikace nebo do webové části.

Pokud chcete do stránky aplikace zahrnout uživatelský ovládací prvek, otevřete webovou stránku, do které chcete přidat ASP.NET uživatelský ovládací prvek. Přepněte do návrhového zobrazení a pak vyberte vlastní soubor uživatelského ovládacího prvku v Průzkumník řešení a přetáhněte ho na stránku. Na stránku se přidá ASP.NET uživatelský ovládací prvek a návrhář vytvoří direktivu @ Register, která je nutná pro stránku k rozpoznání uživatelského ovládacího prvku. Teď můžete pracovat s veřejnými vlastnostmi a metodami ovládacího prvku.

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

C#

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

VB

<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

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

Pokud chcete ladit uživatelský ovládací prvek, ujistěte se, že je uživatelský ovládací prvek součástí stránky aplikace nebo webové části v projektu Služby SharePoint. Kód v uživatelském ovládacím prvku pak můžete ladit stejně jako v jakémkoli projektu sady Visual Studio.

Když spustíte ladicí program sady Visual Studio, visual Studio otevře sharepointový web.

Na SharePointu otevřete stránku aplikace, která obsahuje uživatelský ovládací prvek. Pokud je uživatelský ovládací prvek součástí webové části, přidejte webovou část na stránku webových částí na SharePointu.

Další informace o ladění projektů Služby SharePoint naleznete v tématu Řešení potíží se službou SharePoint.

Příbuzná témata

Titulek	Popis
Postupy: Vytvoření uživatelského ovládacího prvku pro stránku nebo webovou část aplikace SharePoint	Ukazuje, jak vytvořit vlastní opakovaně použitelné ovládací prvky, které můžou využívat stránky aplikací a Webové části, které běží na SharePointu.