Erstellen von Webparts für SharePoint

Artikel
03/26/2013

Durch die Webparts verwenden, können Benutzer Inhalt, Darstellung und Verhalten von SharePoint-Websiteseiten mithilfe eines Browsers direkt ändern, indem sie einen Browser verwenden.Webparts sind serverseitige Steuerelemente, die in einem speziellen Typs Seite aufgerufen eine Webpartseite ausgeführt werden: Sie sind die Bausteine der Seiten, die auf einer SharePoint-Website angezeigt werden.Weitere Informationen zu Webparts in SharePoint, finden Sie unter Baustein: Webparts.

Visual Studio stellt Vorlagen bereit, die Sie verwenden können, um Webparts auf einer SharePoint-Website zu erstellen und zu debuggen.

Erstellen eines Webparts in Visual Studio

Erstellen Sie ein Webpart, indem Sie ein Webpart-Element zu einem SharePoint-Projekt hinzufügen.Sie können ein Element Webpart in einer Sandkastenlösung oder einer Farmlösung verwenden.

Wenn Sie ein Webpart, indem Sie einen Designer visuell entwerfen möchten, ein Visuelles Webpart Projekt erstellen oder Visuelles Webpart jedem SharePoint-Projekt ein Element hinzufügen möchten.Sie können ein Element Visuelles Webpart nur in einer Farmlösung verwenden.

Webpartelement

Ein Webpart-Element stellt Dateien bereit, die Sie verwenden können, um ein Webpart für eine SharePoint-Website zu entwerfen.Wenn Sie ein Webpart-Element 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	Description
Elements.xml	Enthält Informationen, die der Funktionsdefinitionsdatei im Projekt verwendet, um das Webpart bereitzustellen.
WEBPART-Datei	Stellt Informationen bereit, die SharePoint benötigt, um das Webpart in einem Webpartkatalog anzuzeigen.
Codedatei	Enthält Methoden, die Steuerelemente zum Webpart hinzufügen und die benutzerdefinierten Inhalt innerhalb des Webparts generieren.

Weitere Informationen finden Sie unter Gewusst wie: Erstellen eines SharePoint-Webparts.

Element Visuelles Webpart

Ein visuelles Webpart ist ein Webpart, das Sie erstellen, mit dem Visual Web Developer-Designer in Visual Studio.Weitere Informationen darüber, wie Sie den Designer, finden Sie unter Beta von Visual Studio-11 für Web-Inhalts-Karte verwendet.

Funktionell ist ein visuelles Webpart zu einem Webpart nicht unterschiedlich.Ein Element Visuelles Webpart schließt ein Element Webpart und ein Element Benutzersteuerelement ein.

Sie können die Darstellung des Webparts entwerfen, indem Sie Steuerelemente aus Visual Studio Werkzeugkasten auf die Oberfläche des Benutzersteuerelements ziehen oder kopieren.Weitere Informationen finden Sie unter Gewusst wie: Erstellen eines SharePoint-Webparts mithilfe eines Designers.

SharePoint-Steuerelemente

Visual Studio stellt einige Steuerelemente zum Erstellen von SharePoint-Seiten, wie Anwendungsseiten bereit.Diese Steuerelemente werden in der Toolbox unter SharePoint-Steuerelemente.Die Funktionalität dieser Steuerelemente abgeleitet vom Microsoft.SharePoint.WebControls-Namespace, der ASP.NET-Serversteuerelemente enthält, auf die SharePoint-Website und Listenseiten verwendet werden.

Steuerelementname	Description
AspMenu	Fügt ein ASP-Menü ein.Weitere Informationen finden Sie unter Menü-Steuerelement-Übersicht.
CssLink	Fügt ein Element LINK in der ASPX-Seite ein und wendet eine oder mehrere externen Stylesheets, die von CssRegistration definiert werden.
DateTimeControl	Fügt ein Datum-Zeit-Steuerelement in der ASPX-Seite ein.
FormDigest	Fügt eine Sicherheitsvalidierung in der ASPX-Seite ein
ListProperty	Gibt eine Eigenschaft einer angegebenen Liste zurück.
ProjectProperty	Gibt eine globale Eigenschaft der aktuellen Website zurück.
RssLink	Fügt einen Link zu einem RSS-Feed in der ASPX-Seite ein.
ScriptLink	Stellt Eigenschaften und Methoden zum Registrieren von Ressourcen, wie Skripts, auf einer Seite, damit sie angefordert werden können, wenn die Seite gerendert wird.
Design	Wendet ein Design zur ASPX-Seite.

Debuggen eines Webparts

Sie können ein SharePoint-Projekt, das ein Webpart enthält, ebenso wie andere Visual Studio-Projekte debuggen.Wenn Sie den Visual Studio-Debugger starten, wird von Visual Studio die SharePoint-Website geöffnet.

Zu Beginn um den Code zu debuggen, fügen Sie das Webpart einer Webpartseite in SharePoint hinzu.

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

Visuelle Webpart-Einschränkungen

Ab in Visual Studio, können Sie visuelle Webparts Sandkastensharepoint-lösungen und -Farmlösungen hinzufügen.Allerdings besitzen visuelle Webparts die folgenden Einschränkungen:

Visuelle Webparts unterstützen keine ersetzbare Parameter.Weitere Informationen finden Sie unter Ersetzbare Parameter.
Benutzersteuerelemente oder visuellen Webparts können nicht auf visuelle Webparts gezogen werden und abgelegt werden oder kopiert werden.Diese Aktion führt zu Buildfehlern.
Visuelle Webparts nicht direkt unterstützen SharePoint-Server-Token wie $SPUrl.Weitere Informationen finden Sie unter "Scheineinschränkungen in den Sandkasten-visuellen Webparts" im Thema Problembehandlung bei SharePoint-Lösungen.
Visuelle Webparts in einer Sandkastenlösung rufen gelegentlich den Fehler ab, die Sandkastencode-Ausführungsanforderung "wurde abgelehnt, da der Sandkasten-Code-Host-Service ausgelastet war, die Anforderung bearbeiten". Weitere Informationen zu diesem Fehler, wird dieser Beitrag in SharePoint-Entwickler-Team-Blog.
Serverseitiges JavaScript-Debuggen wird nicht in Visual Studio unterstützt, aber clientseitiges JavaScript-Debuggen wird unterstützt.

Obwohl Sie inline JavaScript einer serverseitigen Markupdatei hinzufügen können, wird das Debuggen nicht für die Haltepunkte unterstützt, die dem Markup hinzugefügt werden.Um JavaScript zu debuggen, verweisen Sie auf eine externe JavaScript-Datei in der Markupdatei dazu, und legen Sie die Haltepunkte in der JavaScript-Datei fest.
Debuggen inline ASP.NET Code muss in der generierten Codedatei statt in der Markupdatei ausgeführt werden.
Visuelle Webparts unterstützen nicht die Verwendung von den <@ Assembly Src=-Direktive.
SharePoint-Websteuerelemente und einige ASP.NET-Steuerelemente werden nicht in die SharePoint-Sandkastenumgebung unterstützt.Wenn denen Sie nicht unterstützte Steuerelemente für ein visuelles Webpart in einer Sandkastenlösung verwendet werden, ist der Fehler, "das Typ oder Namespacename "Design" nicht im Namespace "Microsoft.SharePoint.WebControls"" wird angezeigt.

Weitere Informationen über Sandkastenlösungen, finden Sie unter Unterschiede zwischen Sandkasten- und Farmlösungen.

Erstellen von SharePoint-basierten Webparts im älteren Format

Sie können die Vorlagen in Visual Studio verwenden, um benutzerdefinierte ASP.NET 2.0 Webparts für SharePoint erstellen.ASP.NET 2.0 Webparts werden auf die ASP.NET Webpartinfrastruktur erstellt und werden als Typ für neue Projekte.

In seltenen Fällen müssen Sie möglicherweise ein Webpart erstellen, indem Sie das SharePoint-basierten Webpart des älteren Format verwenden.Sie können Visual Studio verwenden, um diese Typen von Webparts erstellen, aber Visual Studio stellt keine Vorlagen bereit, die speziell entworfen wurden, die Ihnen helfen, sie zu erstellen.

Weitere Informationen über, als ein SharePoint-basiertes Webpart des älteren Format erstellt werden, finden Sie unter Webpart-Infrastruktur in Windows SharePoint Services.Weitere Informationen dazu, wie ein Webpart, indem Sie das SharePoint-basierten Webpart des älteren Format verwenden, finden Exemplarische Vorgehensweise, die ein grundlegendes SharePoint-Webpart erstellt Sie unter.

Titel	Description
Gewusst wie: Erstellen eines SharePoint-Webparts	Zeigt, wie Webparts für SharePoint-Seiten.
Gewusst wie: Erstellen eines SharePoint-Webparts mithilfe eines Designers	Zeigt, wie Webparts für SharePoint mithilfe einer visuellen Entwurfsoberfläche erstellt.
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 -Webparten genutzt werden können, die in SharePoint ausgeführt werden.
Exemplarische Vorgehensweise: Erstellen eines Webparts für SharePoint	Beschreibt, wie ein Webpart für SharePoint entworfen wird.
Exemplarische Vorgehensweise: Erstellen eines Webparts für SharePoint mithilfe eines Designers	Beschreibt, wie ein Webpart für SharePoint durch Ziehen von Steuerelementen auf einer visuellen Entwurfsoberfläche entworfen wird.
Exemplarische Vorgehensweise: Erstellen eines Silverlight-Webparts, das OData für SharePoint anzeigt	Beschreibt, wie ein Webpart für SharePoint entworfen werden, die eine Silverlight-Anwendung hostet und Daten aus SharePoint-Listen anzeigt.
Arbeiten mit Visual Web Developer	Beschreibt, wie des Designers, der angezeigt wird, wenn Sie im Projekt eine Webseite öffnen.

Freigeben über