Udostępnij za pośrednictwem

Tworzenie kontrolek wielokrotnego użytku dla składników Web Part lub stron aplikacji

  • Artykuł

W programie Visual Studio można tworzyć niestandardowe kontrolki wielokrotnego użytku, które mogą być używane przez strony aplikacji i składniki Web Part uruchamiane w programie SharePoint. Te kontrolki są nazywane kontrolkami użytkownika. Kontrolka użytkownika jest rodzajem złożonej kontrolki, która działa podobnie jak strona internetowa ASP.NET — można dodać istniejące kontrolki i znaczniki serwera sieci Web do kontrolki użytkownika oraz zdefiniować właściwości i metody dla kontrolki. Następnie można je osadzić na ASP.NET stronach sieci Web, gdzie działają jako jednostka.

Tworzenie kontrolki użytkownika

Aby utworzyć kontrolkę użytkownika, dodaj kontrolkęużytkownika do pustego projektu programu SharePoint. Aby uzyskać więcej informacji, zobacz How to: Create a user control for a SharePoint application page or Web Part (Jak utworzyć kontrolkę użytkownika dla strony aplikacji programu SharePoint lub składnika Web Part).

Po dodaniu elementu Kontrolka użytkownika program Visual Studio tworzy folder w projekcie, a następnie dodaje kilka plików do folderu. W poniższej tabeli opisano każdy plik.

Plik opis
Plik kontroli użytkownika Definiuje kontrolkę użytkownika. Zaprojektuj kontrolkę użytkownika, dodając kontrolki i znaczniki do tego pliku.
Plik kodu Zawiera kod za kontrolką użytkownika. Dodaj kod do obsługi zdarzeń do tego pliku.
Projektant pliku kodu Zawiera kod generowany przez projektanta i nie powinien być edytowany bezpośrednio.

Projektowanie kontrolki użytkownika

Zaprojektuj kontrolkę użytkownika przy użyciu projektanta visual web developer w programie Visual Studio. Ten projektant pojawia się po otwarciu pliku kontrolki użytkownika w projekcie i wybraniu karty Projektowanie .

Korzystanie z kontrolki użytkownika

Kontrolki użytkownika nie są wyświetlane w programie SharePoint, dopóki nie dołączysz ich do strony aplikacji lub składnika Web Part.

Aby dołączyć kontrolkę użytkownika na stronie aplikacji, otwórz stronę sieci Web, do której chcesz dodać kontrolkę użytkownika ASP.NET. Przejdź do widoku projektu, a następnie wybierz niestandardowy plik sterowania użytkownika w Eksplorator rozwiązań i przeciągnij go na stronę. Kontrolka użytkownika ASP.NET jest dodawana do strony, a projektant tworzy dyrektywę @ Register, która jest wymagana, aby strona rozpoznawała kontrolkę użytkownika. Teraz możesz pracować z publicznymi właściwościami i metodami kontrolki.

Aby uwzględnić kontrolkę użytkownika w składniku Web Part, dodaj kontrolkę użytkownika do kolekcji składników Web Part w pliku kodu składnika Web Part Controls . Poniższy przykład dodaje kontrolkę użytkownika do Controls kolekcji składnika Web Part.

[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 kontrolki użytkownika

Aby debugować kontrolkę użytkownika, upewnij się, że kontrolka użytkownika znajduje się na stronie aplikacji lub składniku Web Part w projekcie programu SharePoint. Następnie możesz debugować kod w kontrolce użytkownika tak samo jak kod debugowania w dowolnym projekcie programu Visual Studio.

Po uruchomieniu debugera programu Visual Studio program Visual Studio otwiera witrynę programu SharePoint.

W programie SharePoint otwórz stronę aplikacji, która zawiera kontrolkę użytkownika. Jeśli kontrolka użytkownika znajduje się w składniku Web Part, dodaj składnik Web Part do strony składników Web Part w programie SharePoint.

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

Nazwa opis
Instrukcje: tworzenie kontrolki użytkownika dla strony aplikacji programu SharePoint lub składnika Web Part Przedstawia sposób tworzenia niestandardowych kontrolek wielokrotnego użytku, które mogą być używane przez strony aplikacji i składniki Web Part uruchamiane w programie SharePoint.