Feature, élément (Feature)
Dernière modification : vendredi 28 janvier 2011
S’applique à : SharePoint Foundation 2010
Dans cet article
Attributs
Éléments enfants
Éléments parents
Définit un Composant fonctionnel à activer ou à désactiver au niveau d’une étendue spécifiée.
<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>
Attributs
Attribut |
Description |
|
---|---|---|
ActivateOnDefault |
Argument Boolean facultatif. 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 Composants fonctionnels d'étendue collection de sites (Site) ou 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 |
Argument Boolean facultatif. TRUE si le Composant fonctionnel est activé 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 |
Argument Text facultatif. |
|
DefaultResourceFile |
Argument Text 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 effectue une recherche par défaut dans %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATES\FEATURES\NomComposantFonctionnel\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\14\Resources\MyFile. Culture.resx pour récupérer les ressources localisées pour votre Composant fonctionnel. |
|
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 |
Argument Text obligatoire. Contient l’identificateur global unique (GUID) pour le Composant fonctionnel. |
|
ImageUrl |
Argument Text facultatif. Contient l’URL relative au répertoire /_layouts/IMAGES de l’image à utiliser afin de 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 |
Argument Text 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 |
Argument Text 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 |
Argument Boolean facultatif. TRUE pour spécifier que SharePoint Foundation détermine si des ressources existent pour le Composant fonctionnel en vérifiant que la ressource « sentinelle » standard pour le Composant fonctionnel est présente pour une culture particulière. Le fichier de ressources est nommé en fonction du format <répertoire du Composant fonctionnel>\Resources\Resources. <nom de la culture>.resx, où <nom de la culture> représente le nom qui identifie la culture. SharePoint Foundation prend en charge les formats suivants pour les noms de culture : ll-CC ll-Ssss-CC Exemples de noms de culture : en-US Anglais (États-Unis) de-DE Allemand (Allemagne) fr-FR Français (France) ja-JP Japonais (Japon) sr-Latn-CS Serbe (Latin, Serbie) Le format de la balise de langue IETF (Internet Engineering Task Force) est ll(l)-Ssss-CC, où :
L’attribut RequireResources vous permet de limiter la visibilité de Composants fonctionnels spécifiques selon qu’il existe ou non des ressources dans une langue particulière pour celle-ci. Si le fichier n’est pas présent pour la langue d’un site Web ou d’une collection de sites particuliers, deux comportements peuvent se produire :
La définition de cet attribut s’applique seulement à l’activation des Composants fonctionnels via l’interface utilisateur et non via les opérations de ligne de commande STSADM.EXE ou le modèle objet. |
|
Scope |
Argument Text obligatoire. Spécifie l'étendue dans laquelle le Composant fonctionnel peut être activé, et contient une des valeurs suivantes : Farm (batterie de serveurs), WebApplication (application Web), Site (collection de sites), Web (site Web). Pour plus d'informations sur l'étendue, voir Scope, paramètre de l'élément Feature. |
|
SolutionId |
Argument Text facultatif. Spécifie la solution à laquelle appartient le Composant fonctionnel. |
|
Title |
Argument Text facultatif. Renvoie le titre du Composant fonctionnel. Limité à 255 caractères. |
|
UIVersion |
Argument Text facultatif. Spécifie la version d’interface utilisateur pour cette fonctionnalité. UIVersion est spécifiée de multiples façons.
|
|
Version |
Argument Text facultatif. Spécifie une représentation conforme à System.Version de la version d’un Composant fonctionnel. Il peut s’agir de quatre nombres délimités par des décimales qui représentent une version. |
Éléments enfants
ActivationDependencies, ElementManifests, Properties, UpgradeActions, élément (Feature) |
Éléments parents
Aucun |
Remarques
SharePoint Foundation prend en charge uniquement les caractères ASCII de poids faible, et exclut les espaces, pour les noms de dossiers et de fichiers des Composants fonctionnels.
Exemple
Pour obtenir un exemple d'utilisation de cet élément, voir Fichiers Feature.xml.