Tworzenie formantów wielokrotnych dla części sieciowych lub stron aplikacji

W programie Visual Studio można utworzyć formantów niestandardowych, wielokrotnego użytku, które mogą być spożywane przez strony aplikacji i składników Web Part w programie SharePoint.Formanty te są nazywane formantów użytkownika.Aby uzyskać więcej informacji na temat formantów użytkownika, zobacz ASP.NET User Controls.

Tworzenie formantu użytkownika

Aby utworzyć formant użytkownika, należy dodać Kontrola użytkownika do Pusty projekt SharePoint.Aby uzyskać więcej informacji, zobacz Porady: tworzenie formantu użytkownika dla części sieciowej lub strony aplikacji SharePoint.

Po dodaniu Kontrola użytkownika przedmiotu, tworzy folder w projekcie programu Visual Studio, a następnie dodaje kilka plików do folderu.W poniższej tabeli opisano każdego pliku.

Plik	Opis
Plik kontroli użytkownika	Definiuje kontroli użytkownika.Projekt kontrola użytkownika, dodając formanty i znaczników do tego pliku.
Kod pliku	Zawiera kod związany formant użytkownika.Dodaj kod do obsługi zdarzeń do tego pliku.
Projektant kod pliku	Zawiera kod generowany przez projektanta i nie powinny być edytowane bezpośrednio.

Projektowania formantu użytkownika

Projekt kontrola użytkownika przy użyciu projektanta Visual Web Developer w Visual Studio.To projektant pojawia się po otwarciu pliku formantu użytkownika w projekcie i wybrać Projekt kartę.Aby uzyskać więcej informacji na temat używania tego projektanta, zobacz W Visual Studio 11 wersji Beta dla mapy zawartości sieci Web.

Zużywa formant użytkownika

Formanty użytkownika nie są wyświetlane w programie SharePoint aż uwzględnić je w strony aplikacji lub składnika Web Part.

Aby dołączyć formant użytkownika na stronie aplikacji należy dodać @Register do strony aplikacji w dyrektywie i następnie zadeklarować formantu użytkownika wewnątrz jednego lub więcej symboli zastępczych zawartości na stronie.Na przykład sposobu wykonania tego zadania w standardowej stronie sieci Web programu ASP.NET, zobacz How to: Include a User Control in an ASP.NET Web Page.

Aby dołączyć formant użytkownika w składniku Web Part, należy dodać formant użytkownika do składnika Web Part Controls kolekcji w pliku kod składnika Web Part.W następującym przykładzie dodano kontrolkę użytkownika do Controls kolekcji części sieci Web.

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

}

Debugowanie formant użytkownika

Debugowanie formant użytkownika, upewnij się, że kontrola użytkownika jest zawarty w stronie aplikacji lub składnika Web Part w projekcie programu SharePoint.Następnie można debugowania kodu w formancie użytkownika, podobnie jak byłoby debugowania kodu w dowolnym projektu programu Visual Studio.

Po uruchomieniu programu Visual Studio debugger, Visual Studio otwiera witrynę programu SharePoint.

W programie SharePoint otwórz strony aplikacji, który zawiera formant użytkownika.Jeśli formant użytkownika znajduje się w składniku Web Part, należy dodać składnik Web Part do strony składników Web Part programu SharePoint.

Aby uzyskać więcej informacji o debugowaniu projektów programu SharePoint, zobacz Rozwiązywanie problemów z rozwiązaniami SharePoint.

Tematy pokrewne

Tytuł	Opis
Porady: tworzenie formantu użytkownika dla części sieciowej lub strony aplikacji SharePoint	Pokazuje sposób tworzenia formantów niestandardowych, wielokrotnego użytku, które mogą być spożywane przez strony aplikacji i składników Web Part w programie SharePoint.
Praca z Visual Web Developer	W tym artykule opisano sposób używania projektanta, który pojawia się podczas otwierania strony sieci Web w projekcie.