Freigeben über


Gewusst wie: Exportieren eines ASP.NET-Webparts und Importieren des Webparts in eine SharePoint Foundation-Website

Letzte Änderung: Freitag, 9. April 2010

Gilt für: SharePoint Foundation 2010

Sie können Microsoft ASP.NET-Webparts in einer eigenen Microsoft SharePoint Foundation-Anwendung wiederverwenden, indem Sie sie als WEBPART-Dateien exportieren. Diese XML-Dateien enthalten Eigenschaftenwerte, Zustandsdaten sowie Einzelheiten zur Assembly oder Quelldatei des Webparts. Da die Exportfunktion nicht standardmäßig verfügbar ist, müssen Sie einige Änderungen am Code des Webparts sowie an den Konfigurationseinstellungen vornehmen.

Sobald Ihnen eine WEBPART-Datei vorliegt, können Sie sie in eine beliebige SharePoint Foundation-Anwendung importieren. Das Webpart wird daraufhin mit dem typischen Aussehen und Verhalten von SharePoint Foundation angezeigt.

So exportieren Sie ein ASP.NET-Webpart

  1. Legen Sie im Webpartcode die ExportMode-Eigenschaft fest, um den Export von Eigenschaften zuzulassen. Im folgenden Code legen wir den Wert auf All fest, sodass auch vertrauliche Eigenschaften exportiert werden können.

    this.ExportMode = WebPartExportMode.All;
    
  2. Ändern Sie den Abschnitt <system.web> der Datei web.config wie folgt:

    <system.web>
       <webparts  enableExport="true" />
    <sytem.web>          
    
  3. Klicken Sie im Menü Webpart auf Export, um eine WEBPART-Datei zu erstellen, die Sie in eine SharePoint Foundation-Websiteseite importieren können.

So importieren Sie eine WEBPART-Anpassungsdatei

  1. Legen Sie die Assembly für das Webpart im Lösungskatalog, im Ordner bin oder im globalen Assemblycache ab.

    Wenn Sie die Assembly im Lösungskatalog platzieren, muss die Assembly als Lösung mit eingeschränkter Sicherheitsstufe gepackt werden, und sie erhält keine Berechtigungen auf Basis vollständiger Vertrauenswürdigkeit. Weitere Informationen zu Lösungen mit eingeschränkter Sicherheitsstufe finden Sie unter Sandkastenlösungen.

    Wenn Sie die Assembly im globalen Assemblycache platzieren, muss die Assembly mit einem starken Namen versehen sein und wird standardmäßig mit Codeberechtigungen auf Basis vollständiger Vertrauenswürdigkeit ausgeführt. Das Webpart steht allen Webanwendungen zur Verfügung.

    Wenn Sie die Assembly im Papierkorb platzieren, erhalten Sie beim Ausführen des Webparts keine Codeberechtigungen auf Basis vollständiger Vertrauenswürdigkeit. Da die Berechtigungen für das Verzeichnis bin standardmäßig äußerst gering sind, müssen Sie ggf. eine neue Vertrauensrichtliniendatei für das Webpart erstellen (empfohlen) oder die Vertrauensstufe in der Datei web.config erhöhen (der Standard ist WSS_Minimal). Informationen zum Erstellen einer CAS-Sicherheitsrichtlinie finden Sie unter Absichern von Webparts in SharePoint Foundation.

  2. Fügen Sie das Webpart der Liste sicherer Steuerelemente in der Datei web.config hinzu:

    <SafeControl 
       Assembly="MyWebPart"
       Namespace="MyWebParts"
       TypeName="*" 
       Safe="True"
    />
    
  3. Navigieren Sie zum Webpartkatalog. Klicken Sie auf dem Menüband für die Serverkomponente in der Kontextgruppe Bibliothekstools auf der Registerkarte Dokumente auf die Schaltfläche Dokumentupload.

  4. Klicken Sie im Dialogfeld Webpartupload auf Durchsuchen, und navigieren Sie zu der im vorhergehenden Verfahren erstellten WEBPART-Datei. Klicken Sie auf OK. Das Webpart wird in der Liste der Webparts aufgeführt.

  5. Navigieren Sie zu der Seite, auf der das Webpart erscheinen soll. Klicken Sie auf dem Menüband für die Serverkomponente auf der Registerkarte Seite auf die Schaltfläche Bearbeiten, um die Seite in den Bearbeitungsmodus zu versetzen.

  6. Klicken Sie in der Kontextgruppe Bearbeitungstools auf der Registerkarte Einfügen auf die Schaltfläche Webpart.

  7. Suchen Sie in der Liste Kategorien nach der Webpartkategorie, und wählen Sie das Webpart in der Liste aus. Klicken Sie auf Hinzufügen. Das Webpart wird auf der Seite genauso wie auf der ASP.NET-Seite angezeigt, nur dieses Mal mit SharePoint Foundation-Standardchrom.

Siehe auch

Konzepte

Absichern von Webparts in SharePoint Foundation

Upgraden von Webparts

Weitere Ressourcen

Developing Web Parts in Windows SharePoint Services