Freigeben über

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

  • Artikel

In dieser exemplarischen Vorgehensweise wird erläutert, wie Sie eine grundlegende Sitedefinition erstellen, die ein visuelles Webpart mit einigen Steuerelementen enthält. Deutlichkeitshalber verfügt das von Ihnen erstellte visuelle Webpart nur über wenige Steuerelemente. Sie können jedoch komplexere SharePoint-Sitedefinitionen erstellen, die mehr Funktionen enthalten.

Diese exemplarische Vorgehensweise enthält die folgenden Aufgaben:

  • Erstellen einer Sitedefinition mithilfe der Visual Studio-Projektvorlage

  • Erstellen einer SharePoint-Site mithilfe einer Sitedefinition in SharePoint

  • Hinzufügen eines visuellen Webparts zur Lösung

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

    Hinweis

    Auf Ihrem Computer werden möglicherweise andere Namen oder Speicherorte für die Benutzeroberflächenelemente von Visual Studio angezeigt als die in den folgenden Anweisungen aufgeführten. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Personalisieren der IDE.

Voraussetzungen

Zum Abschließen dieser exemplarischen Vorgehensweise benötigen Sie Folgendes:

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

  • Visual Studio.

Erstellen einer Sitedefinitionslösung

Erstellen Sie zunächst das Sitedefinitionsprojekt in Visual Studio.

Erstellen eines Sitedefinitionsprojekts

  1. Klicken Sie in der Menüleiste auf Datei>Neu>Projekt. Wenn die IDE auf die Verwendung der Visual Basic-Entwicklungseinstellungen festgelegt ist, klicken Sie auf der Menüleiste auf Datei>Neues Projekt.

    Das Dialogfeld Neues Projekt wird angezeigt.

  2. Erweitern Sie zunächst den Visual C#- bzw. den Visual Basic-Knoten und dann den Knoten SharePoint. Wählen Sie anschließend den Knoten 2010 aus.

  3. Wählen Sie in der Liste Vorlagen die Vorlage SharePoint 2010-Projekt aus.

  4. Geben Sie im Feld NameTestSiteDef ein, und klicken Sie dann auf die Schaltfläche OK.

    Der Assistent zum Anpassen von SharePoint wird angezeigt.

  5. Geben Sie auf der Seite Website und Sicherheitsebene für Debuggen angeben die URL für die SharePoint-Website ein, auf der Sie die Sitedefinition debuggen möchten, oder verwenden Sie den Standardspeicherort (http://System Name/).

  6. Wählen Sie im Abschnitt Wie lautet die Vertrauensebene für diese SharePoint-Lösung? die Optionsschaltfläche Als Farmlösung bereitstellen aus.

    Alle Sitedefinitionsprojekte müssen als Farmlösungen bereitgestellt werden. Weitere Informationen zu Sandboxlösungen im Vergleich zu Farmlösungen finden Sie unter Überlegungen zu Sandboxlösungen.

  7. Klicken Sie auf die Schaltfläche Fertig stellen.

    Das Projekt wird im Projektmappen-Explorer angezeigt.

  8. Wählen Sie im Projektmappen-Explorer den Projektknoten aus, und klicken Sie dann auf der Menüleiste auf Projekt>Neues Element hinzufügen.

  9. Erweitern Sie unter Visual C# oder Visual Basic den Knoten SharePoint, und wählen Sie dann den Knoten 2010 aus.

  10. Wählen Sie im Bereich Vorlagen die Vorlage Sitedefinition aus, belassen Sie den Namen bei SiteDefinition1, und klicken Sie dann auf die Schaltfläche Hinzufügen.

Erstellen eines visuellen Webparts

Erstellen Sie als Nächstes ein visuelles Webpart, das auf der Hauptseite der Sitedefinition angezeigt wird.

Erstellen eines visuellen Webparts

  1. Klicken Sie im Projektmappen-Explorer auf die Schaltfläche Alle Dateien anzeigen.

  2. Wählen Sie den Projektknoten SiteDefinition1 aus, und klicken Sie dann auf der Menüleiste auf Projekt>Neues Element hinzufügen.

    Das Dialogfeld Neues Element hinzufügen wird angezeigt.

  3. Erweitern Sie zunächst den Visual C#- bzw. den Visual Basic-Knoten und dann den Knoten SharePoint. Wählen Sie anschließend den Knoten 2010 aus.

  4. Wählen Sie in der Liste der Vorlagen die Vorlage Visual Web Part aus, behalten Sie den Standardnamen „VisualWebPart1“ bei, und klicken Sie dann auf die Schaltfläche Hinzufügen.

    Die Datei VisualWebPart1.ascx wird geöffnet.

  5. Fügen Sie unten in VisualWebPart1.ascx das folgende Markup hinzu, um dem Formular drei Steuerelemente hinzuzufügen: ein Textfeld, eine Schaltfläche und eine Bezeichnung:

    <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>

  6. Öffnen Sie unter VisualWebPart1.ascx die Datei VisualWebPart1.ascx.cs (für Visual C#) bzw. die Datei VisualWebPart1.ascx.vb (für Visual Basic). Fügen Sie dann den folgenden Code hinzu:

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

    Dieser Code fügt die Funktionalität für das Klicken auf die Schaltfläche des Webparts hinzu.

Hinzufügen des visuellen Webparts zur ASPX-Standardseite

Fügen Sie als Nächstes das visuelle Webpart zur ASPX-Standardseite der Sitedefinition hinzu.

Hinzufügen eines visuellen Webparts zur ASPX-Standardseite

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

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

    Diese Zeile ordnet den Namen „MyWebPartControls“ dem Webpart und dem zugehörigen Code zu. Der Parameter Namespace entspricht dem Namespace, der in der Codedatei VisualWebPart1.ascx verwendet wird.

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

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

    Dieser Code erstellt einen Verweis auf das zuvor erstellte visuelle Webpart.

  3. Öffnen Sie im Projektmappen-Explorer das Kontextmenü für den Knoten SiteDefinition1, und wählen Sie die Option Als Startelement festlegen aus.

Bereitstellen und Ausführen der Sitedefinitionslösung

Stellen Sie dann das Projekt in SharePoint bereit, und führen Sie es aus.

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

  • Klicken Sie auf der Menüleiste auf Build>TestSiteDef bereitstellen.

  • Drücken Sie die Taste F5.

    Visual Studio kompiliert den Code, fügt die Features hinzu, packt alle Dateien in eine SharePoint-Lösungsdatei (WSP) und stellt die WSP-Datei auf SharePoint Server bereit. SharePoint installiert dann die Dateien und aktiviert die Features.

Erstellen einer Site basierend auf der Sitedefinition

Erstellen Sie als Nächstes eine Site mithilfe der neuen Sitedefinition.

Erstellen einer Site mithilfe der Sitedefinition

  1. Auf der SharePoint-Site wird die Seite „Neue SharePoint-Site“ angezeigt.

  2. Geben Sie im Abschnitt Titel und Beschreibung anschließend Meine neue Site für den Titel und eine Beschreibung der Site ein.

  3. Geben Sie im Abschnitt Websiteadresse im Feld URL-Namemynewsite ein.

  4. Wählen Sie im Abschnitt Vorlage die Registerkarte SharePoint-Anpassungen aus.

  5. Wählen Sie in der Liste Vorlage auswählen die Option SiteDefinition1 aus.

  6. Übernehmen Sie für die anderen Einstellungen die Standardwerte, und klicken Sie dann auf die Schaltfläche Erstellen.

    Die neue Site wird angezeigt.

Testen der neuen Site

Testen Sie als Nächstes die neue Site, um zu überprüfen, ob sie ordnungsgemäß funktioniert.

Testen der neuen Site

  • Geben Sie auf der ASPX-Standardseite Text ein, und klicken Sie dann neben dem Textfeld auf die Schaltfläche Bezeichnungstext ändern.

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

Zugehöriger Inhalt