Exemplarische Vorgehensweise: Importieren von Elementen aus einer vorhandenen SharePoint-Website

In dieser exemplarischen Vorgehensweise wird veranschaulicht, wie Elemente aus einer vorhandenen SharePoint-Website in ein Visual Studio-SharePoint Projekt importiert werden.

Diese exemplarische Vorgehensweise enthält die folgenden Aufgaben:

  • Anpassen einer SharePoint-Website durch Hinzufügen einer benutzerdefinierten Websitespalte (wird auch als Feld bezeichnet).

  • Exportieren einer SharePoint-Website in eine WSP-Datei.

  • Importieren der WSP-Datei in Visual Studio-SharePoint mit dem Projekt zum Importieren von WSP.

  • Tipp

    Ihr Computer zeigt möglicherweise für einige der Elemente der Visual Studio-Benutzeroberfläche in der folgenden Anleitung andere Namen oder Standorte an. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Visual Studio-Einstellungen.

Vorbereitungsmaßnahmen

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

Anpassen einer SharePoint-Website

Für dieses Beispiel erstellen Sie eine SharePoint-Unterwebsite und passen diese an, indem Sie eine neue Websitespalte hinzufügen und eine weitere Unterwebsite zur späteren Verwendung erstellen. Später exportieren Sie die erste Unterwebsite in eine WSP-Datei und importieren dann die benutzerdefinierte Websitespalte in die zweite Unterwebsite, indem Sie das Projekt zum Importieren von WSP verwenden.

So erstellen Sie eine SharePoint-Website und passen diese an

  1. Öffnen Sie eine SharePoint-Website in einem Webbrowser, z. B. http://system name/SitePages/Home.aspx.

  2. Erstellen Sie eine Unterwebsite der SharePoint-Hauptsite, indem Sie auf der Registerkarte Websiteaktionen auf Neue Website klicken.

  3. Klicken Sie im Dialogfeld "Website erstellen" auf Leere Website.

  4. Geben Sie im Feld Titel den Titel "Site Column Test 1" und im Feld URL-Name den Namen "columntest1" ein. Übernehmen Sie die Standardwerte für die anderen Einstellungen, und klicken Sie dann auf Erstellen.

  5. Nachdem die Website erstellt wurde, navigieren Sie im Browser wieder zur Hauptsite, http://system name/SitePages/Home.aspx.

  6. Erstellen Sie erneut eine leere Unterwebsite der SharePoint-Website, indem Sie auf der Registerkarte Websiteaktionen auf Neue Website klicken und Leere Website auswählen.

  7. Geben Sie im Feld Titel den Titel "Site Column Test 2" und im Feld URL-Name den Namen "columntest2" ein. Übernehmen Sie die Standardwerte für die anderen Einstellungen, und klicken Sie dann auf Erstellen.

  8. Navigieren Sie zurück zur ersten Unterwebsite, http://system name/columntest1/SitePages/Home.aspx.

  9. Klicken Sie auf der Registerkarte Websiteaktionen auf Websiteeinstellungen, um die Seite Websiteeinstellungen anzuzeigen.

  10. Klicken Sie im Abschnitt Galerien auf den Link Websitespalten.

  11. Klicken Sie am oberen Rand der Seite Websitespaltenkatalog auf die Schaltfläche Erstellen.

  12. Geben Sie im Feld Spaltenname den Namen "Test Column" ein. Übernehmen Sie die anderen Standardwerte, und klicken Sie auf OK.

  13. Die Spalte Test Column wird im Websitespaltenkatalog unter der Überschrift Benutzerdefinierte Spalten angezeigt.

Exportieren der SharePoint-Website

Rufen Sie danach eine SharePoint-Setupdatei (.wsp) ab, die die SharePoint-Elemente und Elemente enthält, die Sie in das Visual Studio-SharePoint-Projekt importieren möchten. Wenn noch keine WSP-Datei vorhanden ist, müssen Sie eine aus einer vorhandenen SharePoint-Website erstellen. In diesem Beispiel exportieren Sie die SharePoint-Standardsite in eine WSP-Datei.

Wichtig

Wenn beim Ausführen der folgenden Prozedur ein Laufzeitfehler auftritt, müssen Sie die Prozedur auf einem System ausführen, das über Zugriff auf die SharePoint-Website verfügt.

So exportieren Sie eine vorhandene SharePoint-Website

  1. Klicken Sie in SharePoint auf der Registerkarte Websiteaktionen auf Websiteeinstellungen, um die Seite Websiteeinstellungen anzuzeigen.

  2. Klicken Sie im Abschnitt Websiteaktionen der Seite Websiteeinstellungen auf den Link Website als Vorlage speichern.

  3. Geben Sie im Feld Dateiname den Namen "ExampleSite" ein, und geben Sie im Feld Vorlagenname den Namen "Example Site" ein.

  4. Lassen Sie in diesem Beispiel das Kontrollkästchen Inhalte einschließen deaktiviert.

    Wenn Sie dieses Kontrollkästchen aktivieren, speichert Visual Studio alle Listen und Dokumentbibliotheken und deren Inhalte in der WSP-Datei. Obwohl dies in einigen Fällen nützlich ist, ist es für dieses Beispiel nicht erforderlich.

  5. Wenn der Vorgang erfolgreich abgeschlossen ist, klicken Sie auf den Link Anwenderlösungskatalog, um die WSP-Datei anzuzeigen.

    Um die Lösungskatalogseite später anzuzeigen, klicken Sie auf der Registerkarte Websiteeinstellungen auf Websiteaktionen, klicken Sie im Abschnitt Websitesammlungsverwaltung auf Zu Websiteeinstellungen der obersten Ebene wechseln, und klicken Sie dann im Abschnitt Galerien auf den Link Projektmappen.

  6. Klicken Sie im Lösungskatalog auf den Link ExampleSite, um das Dialogfeld Dateidownload anzuzeigen.

  7. Klicken Sie im Dialogfeld Dateidownload auf die Schaltfläche Speichern, und speichern Sie die Datei im System.

Importieren der WSP-Datei

Jetzt importieren Sie die WSP-Datei, die ein Element enthält, das Sie wiederverwenden möchten (die benutzerdefinierte Websitespalte Test Column), um darauf zuzugreifen.

So importieren Sie eine WSP-Datei

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

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

  3. Klicken Sie im Bereich Vorlagen auf SharePoint-Lösungspaket importieren, übernehmen Sie den Namen WspImportProject1 des Projekts, und klicken Sie dann auf OK.

    Der Assistent zum Anpassen von SharePoint wird angezeigt.

  4. Geben Sie auf der Seite Site und Sicherheitsebene für Debugging angeben die URL für die zweite SharePoint-Unterwebsite ein, die Sie zuvor erstellt haben. Dieser Unterwebsite fügen Sie das neue benutzerdefinierte Feldelement hinzu, http://system name/columntest2.

  5. Übernehmen Sie im Abschnitt Wie lautet die Vertrauensebene für diese SharePoint-Lösung? die Auswahl Als Sandkastenlösung bereitstellen.

  6. Wechseln Sie auf der Seite Neue Projektquelle angeben zu dem Speicherort im System, an dem Sie zuvor die WSP-Datei gespeichert haben, und klicken Sie dann auf Weiter.

    Tipp

    Wenn Sie auf dieser Seite auf Fertig stellen klicken, werden alle verfügbaren Elemente in der WSP-Datei importiert.

  7. Löschen Sie im Feld Zu importierende Elemente auswählen alle Elemente in der Liste mit Ausnahme von Test Column, und klicken Sie dann auf Fertig stellen.

    Da die Liste viele Elemente enthält, ist es am einfachsten, STRG+A zu drücken, um alle Elemente in der Liste auszuwählen, dann die LEERTASTE zu drücken, um die Auswahl aller Elemente aufzuheben, und dann das Kontrollkästchen neben dem Element Test Column zu aktivieren.

    Nachdem der Importvorgang beendet wurde, wird ein neues Projekt mit dem Namen WspImportProject1 erstellt, das einen Ordner mit dem Namen Felder enthält. In diesem Ordner befinden sich die benutzerdefinierte Websitespalte Test Column sowie deren Definitionsdatei Elements.xml.

Bereitstellen des Projekts

Stellen Sie abschließend WspImportProject1 auf der zweiten SharePoint-Unterwebsite bereit, die Sie zuvor erstellt haben, um die benutzerdefinierte Websitespalte anzuzeigen.

So stellen Sie das Projekt bereit

  1. Drücken Sie in Visual Studio F5, um das WSP-Importprojekt bereitzustellen und auszuführen.

  2. Klicken Sie auf der Registerkarte Websiteaktionen auf Websiteeinstellungen, um die Seite Websiteeinstellungen anzuzeigen.

  3. Klicken Sie im Abschnitt Galerien auf den Link Websitespalten.

  4. Führen Sie einen Bildlauf nach unten zum Abschnitt Benutzerdefinierte Spalten durch.

    Beachten Sie, dass die benutzerdefinierte Websitespalte, die Sie aus der ersten SharePoint-Website importiert haben, in der Liste angezeigt wird.

Siehe auch

Konzepte

Importieren von Elementen aus einer vorhandenen SharePoint-Website

Weitere Ressourcen

Entwickeln von SharePoint-Lösungen

Erstellen von wiederverwendbaren Steuerelementen für Webparts oder Anwendungsseiten