Baustein: Features

Artikel
09/24/2014

Letzte Änderung: Dienstag, 22. Dezember 2009

Gilt für: SharePoint Foundation 2010

Inhalt dieses Artikels
Objektmodell für Features
Für Features verwendetes XML
Bereiche im Zusammenhang mit Features
Weitere Informationen zu Features

Ein Feature ist ein Container, der eine oder mehrere Erweiterungen für Funktionalität in Microsoft SharePoint Foundation enthält. Ein Feature enthält eine Datei Feature.xml und eine oder mehrere Elementdateien. Diese XML-Dateien werden auch als Featuredefinitionen bezeichnet.

Features können Vorlagen, Seiten, Listendefinitionen, Ereignishandler, Workflows, anpassungen und andere Objekte enthalten. Das Verzeichnis mit dem Feature kann auch andere Ressourcendateien wie z. B. Seiten, Bilder, ECMAScript (JavaScript, JScript)-Dateien oder Cascading Stylesheets (CSS) enthalten. Features können auch von einem anderen Feature abhängig sein, das auf einen umfangreicheren Bereich angewendet wurde. Beispielsweise kann ein Feature, das auf die Websiteebene ausgelegt ist, von einem Feature abhängig sein, das auf die Websitesammlungsebene ausgelegt ist. Ein Feature, das auf einem höheren Bereich aktiviert ist, kann jedoch nicht von einem Feature abhängig sein, das auf einem niedrigeren Bereich aktiviert ist.

Features enthalten auch Featureempfänger. Hierbei handelt es sich um Assemblys, die Code enthalten, der beim Installieren, Deinstallieren, Aktivieren, Deaktivieren oder Upgraden eines Features ausgeführt wird. Weitere Informationen zu Featureempfängern finden Sie unter Featureereignisse.

Serverfarm – das Feature ist in der Serverfarm verfügbar.
Webanwendung – das Feature ist in der Webanwendung verfügbar.
Websitesammlung – das Feature ist in einer Websitesammlung verfügbar.
Website – das Feature ist in einer einzelnen Website verfügbar.

Objektmodell für Features

Features können mit dem SharePoint Foundation-Objektmodell bearbeitet werden. Beispielsweise können Sie Informationen zu einem Feature suchen, eine Liste installierter Features abrufen und Aktivierungsabhängigkeiten bestimmen. Die folgenden Klassen können bei Verwendung des Objektmodells für Features verwendet werden.

Microsoft.SharePoint-Namespace

SPFeature – ein Objekt, das ein Feature repräsentiert. Die Featuresammlung wird in einem SPFeatureCollection-Objekt gespeichert. Auf SPFeatureCollection kann mit der Features-Eigenschaft in den Objekten SPWebService, SPWebApplication, SPSite und SPWeb zugegriffen werden. Falls ein Feature in einer Sammlung vorhanden ist, wurde es im angegebenen Bereich aktiviert.

SPFeatureProperty – ein Objekt, das eine einzelne Eigenschaft in einem SPFeature-Objekt repräsentiert. Die Eigenschaftssammlung wird in einem SPFeaturePropertyCollection-Objekt gespeichert. Auf das SPFeaturePropertyCollection-Objekt kann mit der Properties-Eigenschaft des SPFeature-Objekts zugegriffen werden.

SPFeatureScope – eine Enumeration der verschiedenen Bereiche, die für ein Feature angegeben werden können. Hierzu zählen Farm, WebApplication, Site und Web.

SPFeatureDependency – ein Objekt, das ein Feature repräsentiert, das von einem anderen Feature abhängig ist. Die Featuresammlung, die von einem anderen Feature abhängig ist, wird in einem SPFeatureDependencyCollection-Objekt gespeichert. Auf das SPFeatureDependencyCollection-Objekt kann mit der ActivationDependencies-Eigenschaft des SPFeatureDefinition-Objekts zugegriffen werden.

Microsoft.SharePoint.Administration-Namespace

SPFeatureDefinition – ein Objekt, das die Basisdefinition eines Features repräsentiert, einschließlich des Namens, des Bereichs, der ID und der Version. Die Featuredefinitionssammlung wird in einem SPFeatureDefinitionCollection-Objekt gespeichert. Auf das SPFeatureDefinitionCollection-Objekt kann mit der FeatureDefinitions-Eigenschaft der Objekte SPFarm oder SPSite zugegriffen werden.

SPElementDefinition – ein Objekt, das ein Element repräsentiert, das bereitgestellt wird, wenn ein Feature aktiviert oder verwendet wird. Die Elementdefinitionssammlung wird in einem SPElementDefinitionCollection-Objekt gespeichert. Auf das SPElementDefinitionCollection-Objekt kann mit der GetElementDefinitions(CultureInfo)-Methode des SPFeatureDefinition-Objekts zugegriffen werden.

Für Features verwendetes XML

Features werden in erster Linie mithilfe von zwei XML-Dateien erstellt, nämlich der Datei Feature.xml und einer Featureelementdatei. Diese beiden Dateien definieren den Bereich, Abhängigkeiten und verwandte Dateien, die auf dem Front-End-Webserver bereitgestellt werden.

Featureelement-Manifestdatei

Mit der Datei Feature.xml wird der Speicherort von Assemblys, Dateien, Abhängigkeiten oder Eigenschaften angegeben, die das Feature unterstützen. Das ElementManifest-Element (Feature)-Element zeigt auf die zugehörige Featuremanifestdatei, mit der das Feature definiert wird. Weitere Informationen zu den Werten, die für Attribute verwendet werden, finden Sie unter "Feature.xml"-Dateien. Im Folgenden finden Sie eine einfache Version der Datei Feature.xml.

<Feature Title="Feature Title"
  Scope="FeatureScope" 
  Id="GUID" 
  xmlns="https://schemas.microsoft.com/sharepoint/">
  <ElementManifests>
    <ElementManifest Location="FeatureManifestFileName.xml" />
  </ElementManifests>
</Feature>

Featureelementdatei

Für eine Featureelementdatei ist ein beliebiger Name zulässig. Beim Definieren der Datei Feature.xml müssen Sie den Dateinamen im ElementManifest-Element (Feature)-Element angeben. Diese Datei kann ein CustomAction-Element-Element, Anpassungen der Benutzerschnittstelle, Menübandanpassungen und viele andere Anpassungen enthalten. Weitere Informationen zur Dateistruktur finden Sie unter Featureschemas. Im Folgenden finden Sie ein Beispiel für eine Featureelementdatei.

<?xml version="1.0" encoding="utf-8"?>
<Elements xmlns="https://schemas.microsoft.com/sharepoint/">
  <CustomAction Id="Ribbon.Library.Actions.AddAButton"
    Location="ViewToolbar"
    RegistrationId="101"
    RegistrationType="List"
    Title="Add a Ribbon Button">
    <CommandUIExtension>
      <CommandUIDefinitions>
        <CommandUIDefinition
          Location="Ribbon.Library.Actions.Controls._children">
          <Button Id="Ribbon.Library.Actions.Controls.NewRibbonButton"
            Command="NewRibbonButtonCommand"
            Image16by16="/_layouts/images/FILMSTRP.GIF"
            Image32by32="/_layouts/images/PPEOPLE.GIF"
            LabelText="Hello World"
            TemplateAlias="o2" />
        </CommandUIDefinition>
      </CommandUIDefinitions>
      <CommandUIHandlers>
        <CommandUIHandler 
          Command="NewRibbonButtonCommand"
          CommandScript="javascript:alert('Hello, world');" />
      </CommandUIHandlers>
    </CommandUIExtension>
  </CustomAction>
</Elements>