Gewusst wie: Erstellen und Bereitstellen von Featureempfängern in Sandkastenlösungen

Letzte Änderung: Donnerstag, 14. April 2011

Gilt für: SharePoint Foundation 2010

Verfügbar in SharePoint Online

In diesem Thema wird beschrieben, wie Sie einen Featureempfänger in einer Lösung mit eingeschränkter Sicherheitsstufe erstellen und bereitstellen.

So erstellen Sie den Featureempfänger

1. Starten Sie in Microsoft Visual Studio ein leeresSharePoint-Projekt. Wenn Sie dazu aufgefordert werden, legen Sie es als Lösung mit eingeschränkter Sicherheitsstufe fest.

2. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Ordner Features, und wählen Sie Funktion hinzufügen aus.

3. Klicken Sie mit der rechten Maustaste auf die Funktion, und klicken Sie dann auf Ereignisempfänger hinzufügen.

4. Öffnen Sie die Datei CS- oder VB-Datei, die in einem der vorherigen Schritte erstellt wurde.

5. Kommentieren Sie die Ereignishandler in der Datei bei Bedarf mithilfe Ihrer Ereignisbehandlungslogik aus, und überschreiben Sie sie. Allgemein gilt, dass Sie beim Überschreiben des FeatureActivated-Handlers auch den FeatureDeactivating-Handler überschreiben sollten, um die vom Code ausgeführten Aktionen im FeatureActivated-Handler rückgängig zu machen. Entsprechend sollten Sie beim Überschreiben des FeatureInstalled-Handlers auch den FeatureUninstalling-Handler überschreiben, um die vom Code ausgeführten Aktionen im FeatureInstalled-Handler rückgängig zu machen.

   Wichtig

   Der Code muss den Einschränkungen für den gesamten Code, der in einer Lösung mit eingeschränkter Sicherheitsstufe ausgeführt wird, entsprechen. Dies ist der einzige Unterschied zwischen einem Featureempfänger in einer Farmlösung und einem Featureempfänger in einer Lösung mit eingeschränkter Sicherheitsstufe. Beispielsweise kann mit dem Code nicht auf das Dateisystem der Farmserver zugegriffen werden. Der Zugriff auf Elemente außerhalb der Websitesammlung, in der der Code ausgeführt wird, ist ebenfalls nicht möglich.

   Beispielsweise wird mit der folgenden Überschreibung von FeatureActivated eine Zeichenfolge an den Titel der Stammwebsite der übergeordneten Websitesammlung angefügt. Und mit der Überschreibung von FeatureDeactivating wird diese Änderung rückgängig gemacht.

   public override void FeatureActivated(SPFeatureReceiverProperties properties)
   {
       SPWeb website = (SPWeb)properties.Feature.Parent;
       SPSite siteCollection = website.Site;
       siteCollection.RootWeb.Title = siteCollection.RootWeb.Title + " with Ketchup!"; 
       siteCollection.RootWeb.Update();
   }
   
   public override void FeatureDeactivating(SPFeatureReceiverProperties properties)
   {
       SPWeb website = (SPWeb)properties.Feature.Parent;
       SPSite siteCollection = website.Site;
       siteCollection.RootWeb.Title = siteCollection.RootWeb.Title.Replace(" with Ketchup!", string.Empty);
       siteCollection.RootWeb.Update();
   }
   

6. Erstellen, packen und stellen Sie in Ihrer SharePoint-Bereitstellungsinstallation bereit. Stellen Sie das Lösung mit eingeschränkter Sicherheitsstufepaket (WSP-Datei) nach Abschluss der Test- und Debugphase den Websitesammlungsadministratoren zur Verfügung.

Bereitstellen der Sandkastenlösung

Ein Websitesammlungsadministrator kann eine Lösung mit eingeschränkter Sicherheitsstufe im Lösungskatalog der Websitesammlung installieren. Dieser Vorgang besteht aus zwei Schritten. Im ersten Schritt wird das Lösungspaket in den Lösungskatalog hochgeladen. Im zweiten Schritt wird es bereitgestellt, was für Lösungen mit eingeschränkter Sicherheitsstufe als "Aktivierung" bezeichnet wird. Mit dem zweiten Schritt werden automatisch alle Features des Pakets aktiviert. Falls Lösungsvalidierer für die Websitesammlung registriert sind, werden sie ebenfalls in der Aktivierungsphase ausgeführt. Wenn die Lösung die Validierung besteht und nicht von einem Farmadministrator blockiert wurde, kann sie in der Websitesammlung verwendet werden.

Siehe auch

Konzepte

Möglichkeiten und Einschränkungen von Sandkastenlösungen

Einschränkungen bei Sandkastenlösungen