Feature, élément (Feature)
S’applique à : SharePoint 2016 | SharePoint Foundation 2013 | SharePoint En ligne | SharePoint Server 2013
Définit un Composant fonctionnel à activer ou à désactiver au niveau d’une étendue spécifiée.
Définition
<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>
Éléments et attributs
Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.
Attributs
Attribut |
Description |
|
|---|---|---|
**ActivateOnDefault** |
Facultatif **Boolean**. **TRUE** si le Composant fonctionnel est activé par défaut pendant l’installation ou lorsqu’une application Web est créée ; **FALSE** si le Composant fonctionnel n’est pas activé. Cet attribut correspond à **TRUE** par défaut. **L’attribut ActivateOnDefault** ne s’applique pas aux fonctionnalités de collection de sites (**Site**) ou de site **web (Web).** En général, les Composants fonctionnels d'étendue **Farm** deviennent activés au cours de l’installation, et lorsqu’une nouvelle application Web est créée, tous les Composants fonctionnels installés, contenus dans celle-ci et d'étendue **Web application**, deviennent activés. |
|
**AlwaysForceInstall** |
Argument **Boolean** facultatif. **TRUE** si le Composant fonctionnel est installé d’office au cours de l’installation, même s’il est déjà installé. Par exemple, si la valeur est **TRUE**, les gestionnaires d’événements du déploiement du Composant fonctionnel se déclenchent systématiquement chaque fois qu’un utilisateur tente d’installer le composant fonctionnel (même si celui-ci est déjà installé) à l’aide de l’opération de ligne de commande **scanforfeatures** ou **installfeature**. Cet attribut correspond à **FALSE** par défaut. L’attribut **AlwaysForceInstall** affecte les Composants fonctionnels de toutes étendues. |
|
**AutoActivateInCentralAdmin** |
Facultatif **Boolean**. **TRUE** si la fonctionnalité est activée par défaut dans le site web d’administration, la collection de sites ou l’application Web. Cet attribut correspond à **FALSE** par défaut. L’attribut **AutoActivateInCentralAdmin** ne s’applique pas aux Composants fonctionnels d'étendue **Farm**. |
|
**Creator** |
Texte **facultatif**. |
|
**DefaultResourceFile** |
Texte **facultatif**. Indique un fichier de ressources courantes pour la récupération des ressources XML des Composants fonctionnels. Si vous ne spécifiez pas de ressource dans le fichier, SharePoint Foundation recherche par défaut dans %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATES\FEATURES \* FeatureName*\Resources\Resources._Culture_.resx. Toutefois, si vous souhaitez fournir un fichier de ressources essentielles partagé pour tous les Composants fonctionnels dans votre application, vous pouvez spécifier un fichier de remplacement par le biais duquel accéder aux ressources à l’aide de **DefaultResourceFile**. Par exemple, si vous définissez **DefaultResourceFile**= »_MyFile_« , SharePoint Foundation recherche dans %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\Resources \* MyFile*._Culture_.resx pour récupérer des ressources localisées pour votre fonctionnalité. |
|
**Description** |
Argument **String** facultatif. Retourne une représentation plus longue de ce que fait le Composant fonctionnel. |
|
**Hidden** |
Argument **Boolean** facultatif. Cet attribut correspond à **FALSE** par défaut. |
|
**Id** |
Texte **obligatoire**. Contient l’identificateur global unique (GUID) pour le Composant fonctionnel. |
|
**ImageUrl** |
Texte **facultatif**. Contient une URL relative au répertoire layouts/IMAGES pour une image à utiliser pour représenter la fonctionnalité dans \_ l’interface utilisateur. |
|
**ImageUrlAltText** |
Argument **Text** facultatif. Contient le texte de remplacement pour l’image qui représente la fonctionnalité. |
|
**ReceiverAssembly** |
Texte **facultatif**. Si défini en même temps que **ReceiverClass**, spécifie le nom fort de l’assembly signé situé dans le Global Assembly Cache à partir duquel charger un récepteur pour gérer les événements des Composants fonctionnels. |
|
**ReceiverClass** |
Texte **facultatif**. Si défini en même temps que **ReceiverAssembly**, spécifie la classe qui implémente le processeur des événements des Composants fonctionnels. |
|
**RequireResources** |
Facultatif **Boolean**. **TRUE** pour spécifier que SharePoint Foundation vérifie si des ressources existent pour le Feature en vérifiant que la ressource « sentinel » standard pour le Feature est présente pour une culture particulière. Le fichier de ressources est nommé selon le format ' Éléments enfants
Éléments parentsAucun RemarquesSharePoint Foundation prend en charge uniquement les caractères ASCII de bas ordre et aucun espace pour les noms de dossiers et de fichiers feature. ExemplePour obtenir un exemple de la façon dont cet élément est utilisé, voir Feature.xml Files. |