Erstellen von wiederverwendbaren Steuerelementen für Webparts oder Anwendungsseiten

In Visual Studio können Sie benutzerdefinierte, wiederverwendbare Steuerelemente erstellen, die von Anwendungsseiten und Webparts genutzt werden können, die in SharePoint ausgeführt werden. Diese Steuerelemente werden Benutzersteuerelemente genannt. Weitere Informationen über Benutzersteuerelemente finden Sie unter ASP.NET-Benutzersteuerelemente.

Erstellen eines Benutzersteuerelements

Um ein Benutzersteuerelement zu erstellen, fügen Sie einem leeren SharePoint-Projekt ein Benutzersteuerelement hinzu. Weitere Informationen finden Sie unter Gewusst wie: Erstellen eines Benutzersteuerelements für eine SharePoint-Anwendungsseite oder ein SharePoint-Webpart.

Wenn Sie ein Element Benutzersteuerelement hinzufügen, erstellt Visual Studio einen Ordner im Projekt und fügt diesem Ordner dann mehrere Dateien hinzu. In der folgenden Tabelle werden die einzelnen Dateien beschrieben.

Datei	Beschreibung
Benutzersteuerelementdatei	Definiert das Benutzersteuerelement. Entwerfen Sie das Benutzersteuerelement, indem Sie dieser Datei Steuerelemente und Markup hinzufügen.
Codedatei	Enthält Code hinter dem Benutzersteuerelement. Fügen Sie dieser Datei Code hinzu, um Ereignisse zu behandeln.
Designercodedatei	Enthält vom Designer generierten Code und sollte nicht direkt bearbeitet werden.

Entwerfen des Benutzersteuerelements

Entwerfen Sie das Benutzersteuerelement mit dem Visual Web Developer-Designer in Visual Studio. Dieser Designer wird angezeigt, wenn Sie auf die Benutzersteuerelementdatei im Projekt doppelklicken. Weitere Informationen zur Verwendung dieses Designers finden Sie unter Einstieg in Visual Web Developer.

Verwenden des Benutzersteuerelements

Benutzersteuerelemente werden erst in SharePoint angezeigt, wenn Sie sie in eine Anwendungsseite oder ein Webpart einschließen.

Um ein Benutzersteuerelement in eine Anwendungsseite einzuschließen, fügen Sie der Anwendungsseite eine @ Register-Direktive hinzu, und deklarieren Sie dann das Benutzersteuerelement innerhalb eines oder mehrerer Inhaltsplatzhalter auf der Seite. Ein Beispiel zum Ausführen dieser Aufgabe in einer Standard-ASP.NET-Webseite finden Sie unter Gewusst wie: Einfügen eines Benutzersteuerelements in eine ASP.NET-Webseite.

Um ein Benutzersteuerelement in ein Webpart einzuschließen, fügen Sie der Controls-Auflistung des Webparts das Benutzersteuerelement in der Webpartcodedatei hinzu. Im folgenden Beispiel wird der Controls-Auflistung eines Webparts ein Benutzersteuerelement hinzugefügt.

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

}

Debuggen eines Benutzersteuerelements

Um ein Benutzersteuerelement zu debuggen, stellen Sie sicher, dass das Benutzersteuerelement im SharePoint-Projekt in einer Anwendungsseite oder einem Webpart enthalten ist. Sie können dann Code im Benutzersteuerelement auf dieselbe Weise debuggen, wie Sie Code in einem Visual Studio-Projekt debuggen.

Wenn Sie den Visual Studio-Debugger starten, wird von Visual Studio die SharePoint-Website geöffnet.

Öffnen Sie in SharePoint die Anwendungsseite, die das Benutzersteuerelement enthält. Wenn das Benutzersteuerelement in einem Webpart enthalten ist, fügen Sie das Webpart zu einer Webpartseite in SharePoint hinzu.

Weitere Informationen zum Debuggen von SharePoint-Projekten finden Sie unter Problembehandlung bei SharePoint-Lösungen.

Verwandte Themen

Titel	Beschreibung
Gewusst wie: Erstellen eines Benutzersteuerelements für eine SharePoint-Anwendungsseite oder ein SharePoint-Webpart	Zeigt, wie Sie benutzerdefinierte, wiederverwendbare Steuerelemente erstellen, die von Anwendungsseiten und Webparts genutzt werden können, die in SharePoint ausgeführt werden.
Arbeiten mit Visual Web Developer	Beschreibt die Verwendung des Designers, der angezeigt wird, wenn Sie im Projekt eine Webseite öffnen.