Exemplarische Vorgehensweise: Erstellen eines einfachen Projekts für eine Websitedefinition

In dieser exemplarischen Vorgehensweise wird erläutert, wie eine grundlegende Websitedefinition erstellt wird, die ein visuelles Webpart mit einigen Steuerelementen enthält. Aus Übersichtsgründen verfügt das visuelle Webpart, das Sie erstellen, nur über wenige Steuerelemente. Sie können jedoch auch anspruchsvollere SharePoint-Websitedefinitionen mit mehr Funktionen erstellen. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Erstellen einer Websitedefinition mit zusätzlichen Inhalten.

Diese exemplarische Vorgehensweise enthält die folgenden Aufgaben:

• Erstellen einer Websitedefinition mit der Visual Studio-Projektvorlage.

• Erstellen einer SharePoint-Website mithilfe einer Websitedefinition in SharePoint.

• Hinzufügen eines visuellen Webparts zur Lösung.

• Anpassen der Seite default.aspx der Website durch Hinzufügen des neuen visuellen Webparts.

Vorbereitungsmaßnahmen

Zum Durchführen dieser exemplarischen Vorgehensweise benötigen Sie die folgenden Komponenten:

• Unterstützte Editionen von Microsoft Windows und SharePoint. Weitere Informationen finden Sie unter "Anforderungen für die Entwicklung von SharePoint-Lösungen".

• Visual Studio 2010.

Erstellen einer Websitedefinitionslösung

Erstellen Sie zunächst das Websitedefinitionsprojekt in Visual Studio.

So erstellen Sie ein Websitedefinitionsprojekt

1. Zeigen Sie das Dialogfeld Neues Projekt an, indem Sie im Menü Datei auf Neu zeigen und dann auf Projekt klicken.

2. Erweitern Sie unter Visual C# oder Visual Basic den Knoten SharePoint, erweitern Sie dann SharePoint, und klicken Sie dann auf 2010.

3. Wählen Sie im Bereich Vorlagen die Option Websitedefinition aus.

4. Geben Sie im Feld Name den Namen "TestSiteDef" ein, und klicken Sie dann auf OK.

   Der Assistent zum Anpassen von SharePoint wird angezeigt.

5. Geben Sie auf der Seite Site und Sicherheitsebene für Debugging angeben die URL für die SharePoint-Webserversite ein, an der Sie die Websitedefinition debuggen möchten, oder verwenden Sie den Standardspeicherort (http://Systemname/).

6. Übernehmen Sie im Abschnitt Wie lautet die Vertrauensebene für diese SharePoint-Lösung? den Standardwert von Als Farmlösung bereitstellen.

   Alle Websitedefinitionsprojekte müssen als Farmlösungen bereitgestellt werden. Weitere Informationen über Sandkastenlösungen im Vergleich zu Farmlösungen finden Sie in Überlegungen zu Sandkastenlösungen.

7. Klicken Sie auf Fertig stellen. Das Projekt wird im Projektmappen-Explorer angezeigt.

Erstellen eines visuellen Webparts

Erstellen Sie dann ein visuelles Webpart, das auf der Hauptseite der Websitedefinition angezeigt werden soll.

So erstellen Sie ein visuelles Webpart

1. Klicken Sie im Menü Projekt auf Neues Element hinzufügen, um das Dialogfeld Neues Element hinzufügen anzuzeigen.

2. Klicken Sie im Projektmappen-Explorer auf die Schaltfläche Alle Dateien anzeigen, damit alle Dateien angezeigt werden.

3. Wählen Sie in der Strukturansicht Installierte Vorlagen den Knoten Visual Basic oder Visual C# aus, wählen Sie dann SharePoint, dann 2010, und klicken Sie anschließend in der Liste der Projektelementvorlagen auf Visuelles Webpart. Verwenden Sie den Standardnamen VisualWebPart1.

   Hiermit wird die Datei VisualWebPart1UserControl.ascx geöffnet.

4. Fügen Sie am Ende der Datei "VisualWebPart1UserControl.ascx" das folgende Markup hinzu, um dem Formular drei Steuerelemente (ein Textfeld, eine Schaltfläche und eine Bezeichnung) hinzuzufügen:

   <table>
     <tr>
       <td>
         <asp:TextBox runat="server" ID="tbName"></asp:TextBox>
       </td>
       <td>
         <asp:Button runat="server" ID="btnSubmit" Text = "Change Label Text" OnClick="btnSubmit_Click"></asp:Button>
       </td>
       <td>
         <asp:Label runat="server" ID="lblName"></asp:Label>
       </td>
     </tr>
   </table>
   

5. Öffnen Sie die Datei "VisualWebPart1UserControl.ascx.cs" (für Visual C#) oder "VisualWebPart1UserControl.ascx.vb" (für Visual Basic), die sich unter "VisualWebPart1UserControl.ascx" befinden, und fügen Sie folgenden Code hinzu:

   Protected Sub btnSubmit_Click(ByVal sender As Object, ByVal e As EventArgs)
       lblName.Text = tbName.Text
   End Sub
   

   protected void btnSubmit_Click(object sender, EventArgs e)
   {            
       lblName.Text = tbName.Text;
   }
   

   Mit diesem Code wird eine Funktion für das Klicken auf die Schaltfläche des Webparts hinzugefügt.

Hinzufügen des visuellen Webparts zur ASPX-Standardseite

Fügen Sie jetzt der ASPX-Standardseite der Websitedefinition das visuelle Webpart hinzu.

So fügen Sie der ASPX-Standardseite ein visuelles Webpart hinzu

1. Öffnen Sie die Seite default.aspx, und fügen Sie unter dem WebPartPages-Tag Folgendes hinzu:

   <%@ Register Tagprefix="MyWebPartControls" Namespace="TestSiteDef.SiteDefinition.VisualWebPart1" Assembly="$SharePoint.Project.AssemblyFullName$" %>
   

   Diese Zeile ordnet dem Webpart und seinem Code den Namen MyWebPartControls zu. Der Namespace-Parameter entspricht dem in der Codedatei "VisualWebPart1Usercontrol.ascx" verwendeten Namespace.

2. Ersetzen Sie nach dem </asp:Content>-Element den gesamten Abschnitt ContentPlaceHolderId="PlaceHolderMain" und dessen Inhalt durch Folgendes:

   <asp:Content ID="Content1" ContentPlaceHolderId="PlaceHolderMain" runat="server">
       <MyWebPartControls:VisualWebPart1 runat="server" />    
   </asp:Content>
   

   In diesem Code wird ein Verweis auf das zuvor erstellte visuelle Webpart erstellt.

Ausführen und Bereitstellen der Websitedefinitionslösung

Führen Sie dann das Projekt aus, und stellen Sie es in SharePoint bereit.

So führen Sie die Websitedefinition aus und stellen sie bereit

• Drücken Sie F5. Visual Studio kompiliert den Code, fügt die Funktionen hinzu, verpackt alle Dateien in eine WSP-Datei und stellt die WSP-Datei auf dem SharePoint-Server bereit. Anschließend installiert SharePoint die Dateien und aktiviert die Funktionen.

Erstellen einer Website auf Grundlage der Websitedefinition

Erstellen Sie dann eine Website mithilfe der neuen Websitedefinition.

So erstellen Sie eine Website mithilfe der Websitedefinition

1. Auf der SharePoint-Website wird die Seite Neue SharePoint-Website angezeigt.

2. Geben Sie im Abschnitt Titel und Beschreibung für den Titel und die Beschreibung der Website "My New Site" ein.

3. Geben Sie im Abschnitt Websiteadresse im Feld URL-Name den Namen "mynewsite" ein.

4. Klicken Sie im Abschnitt Vorlage auf die Registerkarte SharePoint-Anpassungen, und wählen Sie dann in der Liste Vorlage auswählen den Eintrag TestSiteDef aus.

5. Übernehmen Sie die Standardwerte für die anderen Einstellungen, und klicken Sie dann auf Erstellen.

   Die neue Website wird angezeigt.

Testen der neuen Website

Testen Sie danach die neue Website, um sicherzustellen, dass sie ordnungsgemäß funktioniert.

So testen Sie die neue Website

• Geben Sie im Textfeld auf der ASPX-Standardseite einen Text ein, und klicken Sie dann auf die kleine quadratische Schaltfläche neben dem Textfeld.

  Der Text wird in der Bezeichnung rechts neben der Schaltfläche angezeigt.

Siehe auch

Aufgaben

Gewusst wie: Erstellen eines Ereignisempfängers

Weitere Ressourcen

Exemplarische Vorgehensweise: Erstellen einer Websitedefinition mit zusätzlichen Inhalten

Entwickeln von SharePoint-Lösungen