Freigeben über

Feature-Element (Feature)

  • Artikel

Letzte Änderung: Freitag, 28. Januar 2011

Gilt für: SharePoint Foundation 2010

Inhalt dieses Artikels
Attribute
Untergeordnete Elemente
Übergeordnete Elemente

Definiert ein Feature, das in einem angegebenen Bereich aktiviert oder deaktiviert werden soll.

<Feature
  ActivateOnDefault = "TRUE" | "FALSE"
  AlwaysForceInstall = "TRUE" | "FALSE"
  AutoActivateInCentralAdmin = "TRUE" | "FALSE"
  Creator = "Text" 
  DefaultResourceFile =  "Text"
  Description = "Text" 
  Hidden = "TRUE" | "FALSE"
  Id = "Text"
  ImageUrl = "Text"
  ImageUrlAltText = "Text"
  ReceiverAssembly = "Text"
  ReceiverClass = "Text"
  RequireResources = "TRUE" | "FALSE"
  Scope = "Text"
  SolutionId = "Text"
  Title = "Text"
  UIVersion = "Text"
  Version = "Text" >
</Feature>

Attribute

Attribut

Beschreibung

ActivateOnDefault

Optionaler Boolean-Wert. TRUE, wenn das Feature während der Installation oder beim Erstellen einer Webanwendung standardmäßig aktiviert wird; FALSE, wenn das Feature nicht aktiviert wird. Dieses Attribut ist standardmäßig TRUE. Das ActivateOnDefault-Attribut gilt nicht für Features mit Websitesammlungsbereich (Site) oder Websitebereich (Web).

Im Allgemeinen werden Features mit Farm-Bereich während der Installation aktiviert. Beim Erstellen einer neuen Webanwendung werden alle darin installierten Features mit Web application-Bereich aktiviert.

AlwaysForceInstall

Optionaler Boolean-Wert. TRUE, wenn die Installation des Features während der Installation erzwungen wird, selbst wenn das Feature bereits installiert ist. Ein Beispiel: Bei TRUE werden Ereignishandler für die Featurebereitstellung jedes Mal ausgelöst, wenn ein Benutzer versucht, das Feature mithilfe der Befehlszeilenvorgänge scanforfeatures oder installfeature zu installieren (selbst wenn es bereits installiert ist). Dieses Attribut ist standardmäßig FALSE. Das AlwaysForceInstall-Attribut gilt für Features aller Bereiche.

AutoActivateInCentralAdmin

Optionaler Boolean-Wert. TRUE, wenn das Feature standardmäßig in der Verwaltungswebsite, Websitesammlung oder Webanwendung aktiviert wird. Dieses Attribut ist standardmäßig FALSE. Das AutoActivateInCentralAdmin-Attribut gilt nicht für Features mit Farm-Bereich.

Creator

Optionaler Text-Wert.

DefaultResourceFile

Optionaler Text-Wert. Gibt eine allgemeine Ressourcendatei zum Abrufen von Feature-XML-Ressourcen an. Wenn Sie keine Ressource in der Datei angeben, sucht SharePoint Foundation standardmäßig im Ordner %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATES\FEATURES\FeatureName\Resources\Resources.Kultur.resx. Wenn Sie allerdings eine freigegebene zentrale Ressourcendatei für alle Features in der Anwendung bereitstellen möchten, können Sie mit DefaultResourceFile eine alternative Datei angeben, über die auf Ressourcen zugegriffen werden kann. Wenn Sie beispielsweise DefaultResourceFile="MyFile" festlegen, sucht SharePoint Foundation in %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\Resources\MyFile. Kultur.resx nach lokalisierten Ressourcen für das Feature.

Description

Optionaler String-Wert. Gibt eine längere Darstellung der Featurefunktion zurück.

Hidden

Optionaler Boolean-Wert. Dieses Attribut ist standardmäßig FALSE.

Id

Erforderlicher Text. Enthält die GUID (Globally Unique Identifier) für das Feature.

ImageUrl

Optionaler Text-Wert. Enthält eine relative URL zum Verzeichnis /_layouts/IMAGES für ein Bild, das das Feature auf der Benutzeroberfläche darstellt.

ImageUrlAltText

Optionaler Text-Wert. Enthält den alternativen Text für das Bild, das das Feature darstellt.

ReceiverAssembly

Optionaler Text-Wert. Gibt in Verbindung mit ReceiverClass den starken Namen der signierten Assembly im globalen Assemblycache an, aus der ein Empfänger für die Verarbeitung von Featureereignissen geladen werden soll.

ReceiverClass

Optionaler Text-Wert. Gibt in Verbindung mit ReceiverAssembly die Klasse an, die den Featureereignisprozessor implementiert.

RequireResources

Optionaler Boolean-Wert. TRUE, um anzugeben, dass SharePoint Foundation anhand des Vorhandenseins der standardmäßigen Sentinelressource für das Feature für eine bestimmte Kultur überprüft, ob Ressourcen für das Feature vorhanden sind.

Der Name der Ressourcendatei hat das Format <Featureverzeichnis>\Resources\Resources. <Kulturname>.resx, wobei <Kulturname> der Name für die Kultur ist. SharePoint Foundation unterstützt für Kulturnamen folgende Formate:

ll-CC

ll-Ssss-CC

Beispiele für Kulturnamen:

en-US Englisch (USA)

de-DE Deutsch (Deutschland)

fr-FR Französisch (Frankreich)

ja-JP Japanisch (Japan)

sr-Latn-CS Serbisch (Lateinisch, Serbien)

Das Sprachtagformat der Internet Engineering Task Force (IETF) lautet ll(l)-Ssss-CC, wobei Folgendes gilt:

  • ll(l) ist die obligatorische, aus zwei Buchstaben bestehende Sprach-ID (Angabe mit drei Buchstaben ist möglich, wenn für die Sprache kein ISO-Sprachcode mit zwei Buchstaben existiert).

  • Ssss ist ein optionaler Skriptbezeichner.

  • CC ist ein optionaler Regionsbezeichner.

Mit dem RequireResources-Attribut können Sie die Sichtbarkeit bestimmter Features einschränken, je nachdem, ob für das Feature Ressourcen in einer bestimmten Sprache vorhanden sind.

Wenn die Datei für die Sprache einer bestimmten Website oder Websitesammlung nicht vorhanden ist, gibt es zwei mögliche Verhaltensweisen:

  • Das Feature wird von der Benutzeroberfläche ausgeblendet und steht nicht zur Aktivierung von Features in der Website oder Websitesammlung zur Verfügung, wenn die entsprechenden Ressourcen für die Sprache nicht verfügbar sind.

    Beachten Sie, dass das RequireResources-Attribut nur auf der Benutzeroberfläche erzwungen wird. Ein Feature ohne Ressourcen für eine bestimmte Sprache kann dennoch über Befehlszeilenvorgänge mit stsadm.exe oder über das Objektmodell für eine Website aktiviert werden.

    In SharePoint Foundation wird RequireResources für Features, die Teil einer größeren Websitedefinition sind, nicht erzwungen. Wenn Sie beispielsweise eine Thai-Version einer Websitedefinition bereitstellen, indem Sie die Datei webtempThai.xml im Ordner %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\1054\XML ablegen, müssen Sie sicherstellen, dass für jedes Feature im Ordner geeignete Ressourcen vorhanden sind.

  • Im Allgemeinen stellt SharePoint Foundation sicher, dass Erweiterungskomponenten für die Benutzeroberfläche des Features nicht auf Websites sichtbar sind, denen Ressourcen fehlen. Es gibt aber Ausnahmen. Selbst wenn Sie RequireResources noch so sorgfältig festlegen und Websitedefinitionen nur bereitstellen, wenn alle Features die entsprechenden Ressourcen enthalten, können Features dennoch auch auf Websites erscheinen, auf denen keine Ressourcen verfügbar sind.

    Ein Beispiel: Angenommen, Sie haben ein benutzerdefiniertes Feature mit Ressourcen für zwei Sprachen, das benutzerdefinierte Symbolleisten-Schaltflächen und Links zu Websiteeinstellungen bereitstellt. Außerdem haben Sie eine neue Websitesammlung mit einer Stammwebsite in einer der Sprachen bereitgestellt. Nachdem Sie das Sprachpaket für eine dritte Sprache heruntergeladen und installiert haben, stellen Sie unter der ursprünglichen Stammwebsite eine neue Unterwebsite in dieser dritten Sprache bereit. Wenn RequireResources nicht auf TRUE festgelegt ist, wird das benutzerdefinierte Feature ein Fallback versuchen und Fallbackressourcen verwenden (also Ressourcen, die als Resources\Resources.resx ohne Kultur definiert wurden). Gibt es keine Fallbackressourcen, werden von SharePoint Foundation leere Zeichenfolgen gerendert. Wenn allerdings RequireResources auf TRUE festgelegt wird, werden Erweiterungskomponenten für die Benutzeroberfläche des Features (beispielsweise solche, die über ein CustomAction-Element, ein ListTemplate-Element oder ein FeatureSiteTemplateAssociation-Element definiert wurden) auf Unterwebsites nicht angezeigt, wenn keine Ressourcen verfügbar sind. Die benutzerdefinierten Links und Websiteeinstellungen werden also automatisch verborgen.

Das Festlegen dieses Attributs gilt nur für die Aktivierung von Features über die Benutzeroberfläche, nicht über die Befehlszeilenvorgänge mit STSADM.EXE oder über das Objektmodell.

Scope

Erforderlicher Text-Wert. Gibt den Bereich an, in dem das Feature aktiviert werden kann, und enthält einen der folgenden Werte: Farm (Farm), WebApplication (Webanwendung), Site (Websitesammlung), Web (Website). Informationen zum Bereich finden Sie unter Elementbereich.

SolutionId

Optionaler Text-Wert. Gibt die Lösung an, zu der das Feature gehört.

Title

Optionaler Text-Wert. Gibt den Titel des Features zurück. Maximal 255 Zeichen.

UIVersion

Optionaler Text-Wert. Gibt die Benutzeroberflächenversion für dieses Feature an. Für die Angabe von UIVersion gibt es verschiedene Möglichkeiten.

  • =# – UIVersion der Website muss # entsprechen.

  • <# – UIVersion der Website muss kleiner sein als #.

  • ># – UIVersion der Website muss größer sein als #.

  • <=# – UIVersion der Website muss kleiner als oder gleich # sein.

  • >=# – UIVersion der Website muss größer als oder gleich # sein.

  • #;# – UIVersion der Website muss in der durch Semikolons getrennten Liste mit Zahlen vorhanden sein.

Version

Optionaler Text-Wert. Gibt eine System.Version-konforme Darstellung der Version eines Features an. Kann bis zu vier Zahlen enthalten, die durch Dezimaltrennzeichen voneinander getrennt sind und eine Version darstellen.

Untergeordnete Elemente

ActivationDependencies, ElementManifests, Properties, UpgradeActions-Element (Feature)

Übergeordnete Elemente

Keine

Hinweise

Von SharePoint Foundation werden nur untere ASCII-Zeichen und keine Leerzeichen für die Namen des Featureordners und von Dateien unterstützt.

Beispiel

Ein Beispiel für die Verwendung dieses Elements finden Sie unter "Feature.xml"-Dateien.