Feature, élément (Feature)Feature Element (Feature)

S’applique à: 2016 SharePoint | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013Applies to: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Définit un Composant fonctionnel à activer ou à désactiver au niveau d’une étendue spécifiée.Defines a Feature to activate or deactivate at a specified scope.

DéfinitionDefinition

<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 attributsElements and attributes

Les sections suivantes décrivent les attributs, éléments enfants et éléments parents.The following sections describe attributes, child elements, and parent elements.

AttributsAttributes

AttributAttribute

DescriptionDescription

ActivateOnDefaultActivateOnDefault

Facultatif Boolean.Optional Boolean. TRUE si la fonctionnalité est activée par défaut pendant l’installation ou de la création d’une application Web ; FALSE si la fonctionnalité n’est pas activée.TRUE if the Feature is activated by default during installation or when a Web application is created; FALSE if the Feature is not activated. Cet attribut est égal à TRUE par défaut.This attribute equals TRUE by default. L’attribut ActivateOnDefault ne s’applique pas à la collection de sites (Site) ou les fonctionnalités d’étendue de site Web (Web).The ActivateOnDefault attribute does not apply to site collection (Site) or website (Web) scoped Features.

En général, la batterie de serveurs-fonctionnalités d’étendue deviennent activés au cours de l’installation, et lorsqu’une nouvelle application Web est créée, tous les installés application Web-fonctionnalités étendues qu’il soit activées.In general, Farm-scoped Features become activated during installation, and when a new Web application is created, all installed Web application-scoped Features in it become activated.

AlwaysForceInstallAlwaysForceInstall

Facultatif Boolean.Optional Boolean. TRUE si la fonctionnalité est installée en vigueur lors de l’installation même si la fonctionnalité est déjà installée.TRUE if the Feature is installed by force during installation even if the Feature is already installed. Par exemple, si la valeur TRUE, gestionnaires d’événements de fonctionnalité déploiement se déclenche toujours à tout moment un utilisateur tente d’installer la fonctionnalité (même si elle est déjà installée) à l’aide de le scanforfeatures ou installfeature opération de ligne de commande.For example, if set to TRUE, Feature deployment event handlers will always fire anytime a user tries to install the Feature (even if it is already installed) by using either the scanforfeatures or installfeature command-line operation. Cet attribut est égale à FALSE par défaut.This attribute equals FALSE by default. L’attribut AlwaysForceInstall affecte les fonctionnalités de toutes les étendues.The AlwaysForceInstall attribute affects Features of all scopes.

AutoActivateInCentralAdminAutoActivateInCentralAdmin

Facultatif Boolean.Optional Boolean. TRUE si la fonctionnalité est activée par défaut dans le site Web d’administration, collection de sites ou application Web.TRUE if the Feature is activated by default in the Administrative website, site collection, or Web application. Cet attribut est égale à FALSE par défaut.This attribute equals FALSE by default. L’attribut AutoActivateInCentralAdmin ne s’applique pas à une batterie de serveurs-fonctionnalités d’étendue.The AutoActivateInCentralAdmin attribute does not apply to Farm-scoped Features.

CreatorCreator

Facultatif texte.Optional Text.

DefaultResourceFileDefaultResourceFile

Facultatif texte.Optional Text. Indique un fichier de ressources communes pour récupérer des ressources de code XML de fonctionnalité.Indicates a common resource file for retrieving Feature XML resources. Si vous ne spécifiez pas une ressource dans le fichier, Windows SharePoint Services de recherche par défaut dans %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATES\FEATURES*NomFonctionnalité * \Resources\Resources. Culture.resx.If you do not specify a resource in the file, SharePoint Foundation looks by default in %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 principal partagé pour toutes les fonctionnalités de votre application, vous pouvez spécifier un autre fichier par le biais duquel d’accéder aux ressources à l’aide de **DefaultResourceFile.However, if you want to provide a shared core resource file for all the Features in your application, you can specify an alternate file through which to access resources by using **DefaultResourceFile. Par exemple, si vous définissez **DefaultResourceFile= «MyFile« recherche SharePoint Foundation dans %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\Resources*MyFile *. Culture.resx pour récupérer les ressources localisées pour votre fonctionnalité.For example, if you set **DefaultResourceFile="MyFile", SharePoint Foundation looks in %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\Resources*MyFile.Culture.resx to retrieve localized resources for your Feature.

DescriptionDescription

Valeur chaînefacultative.Optional String. Renvoie une représentation plue de ce que fait la fonctionnalité.Returns a longer representation of what the Feature does.

HiddenHidden

Facultatif Boolean.Optional Boolean. Cet attribut est égale à FALSE par défaut.This attribute equals FALSE by default.

IdId

Textobligatoire.Required Text. Contient l’identificateur global unique (GUID) de la fonctionnalité.Contains the globally unique identifier (GUID) for the Feature.

ImageUrlImageUrl

Facultatif texte.Optional Text. Contient une URL relative à la _répertoire de mises en page/IMAGES pour une image à utiliser pour représenter la fonctionnalité dans l’interface utilisateur (IU).Contains a URL relative to the _layouts/IMAGES directory for an image to use to represent the Feature in the user interface (UI).

ImageUrlAltTextImageUrlAltText

Facultatif texte.Optional Text. Contient le texte de remplacement pour l’image qui représente la fonctionnalité.Contains the alternate text for the image that represents the Feature.

ReceiverAssemblyReceiverAssembly

Facultatif texte.Optional Text. Si défini avec 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 de fonctionnalité.If set along with ReceiverClass, specifies the strong name of the signed assembly located in the global assembly cache from which to load a receiver to handle Feature events.

ReceiverClassReceiverClass

Facultatif texte.Optional Text. Si défini avec ReceiverAssembly, spécifie la classe qui implémente le processeur d’événements de fonctionnalité.If set along with ReceiverAssembly, specifies the class that implements the Feature event processor.

RequireResourcesRequireResources

Facultatif Boolean.Optional Boolean. TRUE pour spécifier que Windows SharePoint Services vérifie si ressources existent pour la fonctionnalité en vérifiant que la ressource sentinelle « standard » pour la fonctionnalité est disponible pour une culture particulière.TRUE to specify that SharePoint Foundation check whether resources exist for the Feature by verifying that the standard "sentinel" resource for the Feature is present for a particular culture.

Le fichier de ressources est nommé d’après le format '\Resources\Resources. .resx, where» est le nom qui identifie la culture.The resource file is named according to the format <Feature Directory>\Resources\Resources.<Culture Name>.resx, where <Culture Name> is the name that identifies the culture. Windows SharePoint Services prend en charge les formats suivants pour les noms de culture :SharePoint Foundation supports the following formats for culture names:

ll-CC

ll-Ssss-CC


Exemples de noms de culture :Culture name examples:

En-US Anglais (États-Unis)en-US English (United States)

de-DE F allemand (Allemagne)de-DE German (Germany)f

fr-FR Français (France)fr-FR French (France)

ja-JP Japonais (Japon)ja-JP Japanese (Japan)

sr-Latn-CS Serbe (Latin, Serbie)sr-Latn-CS Serbian (Latin, Serbia)

Le format de balise de langue Internet Engineering Task Force (IETF) est ll(l)-Ssss-CC, où :The Internet Engineering Task Force (IETF) language tag format is ll(l)-Ssss-CC, where:

  • ll(l)Indique l’identificateur de langue à deux lettres requise (ou trois lettres s’il n’existe aucun code à deux lettres ISO de la langue).ll(l) denotes the required two-letter language identifier (or three-letter if there is no ISO two-letter code for the language).

  • SsssIndique un identificateur de script facultatif.Ssss denotes an optional script identifier.

  • CCIndique un identificateur de région facultatif.CC denotes an optional region identifier.

L’attribut RequireResources permet de limiter la visibilité de certaines fonctionnalités en fonction de l’existent de ressources dans une langue particulière pour la fonctionnalité.The RequireResources attribute allows you to constrict the visibility of certain Features depending on whether resources exist in a particular language for the Feature.

Remarque: SharePoint Foundation n’utilise pas le fichier spécifié par l’attribut DefaultResourceFile , le cas échéant, comme un fichier de sauvegarde pour vérifier la prise en charge d’une langue particulière pour une fonctionnalité.Note: SharePoint Foundation does not use the file specified by the DefaultResourceFile attribute, if there is one, as a backup file for verifying support of a particular language for a feature.

Si le fichier n’est pas présent pour la langue d’un site Web particulier ou d’une collection de sites, deux comportements peuvent se produire :If the file is not present for the language of a particular website or site collection, then two behaviors can occur:

  • La fonctionnalité est masquée dans l’interface utilisateur pour l’activation des fonctionnalités dans la site Web ou collection de sites si les ressources correspondantes pour la langue ne sont pas disponibles.The Feature will be hidden from the user interface for activation of Features in the website or site collection if the corresponding resources for the language are not available.

    N’oubliez pas que l’attribut RequireResources est appliqué dans l’interface utilisateur uniquement.Keep in mind that the RequireResources attribute is enforced in the user interface only. Une fonctionnalité sans ressources pour une langue particulière toujours peut être activée pour un site Web par le biais des opérations de ligne de commande avec stsadm.exe ou le modèle objet.A Feature without resources for a particular language can still be activated for a website through command line operations with stsadm.exe or through the object model.

    SharePoint Foundation n’applique pas RequireResources pour les fonctionnalités qui font partie d’une définition de site plus grande.SharePoint Foundation does not enforce RequireResources for Features that are part of a larger site definition. Si vous spécifiez, par exemple, une version thaï d’une définition de site, le fait de placer un webtempThai.xml dans %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\1054\XML, vous devez vérifier que chaque fonctionnalité contenue dans le dossier possède la ressources appropriées.If you supply, for example, a Thai version of a site definition by putting a webtempThai.xml in %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\1054\XML, you must verify that each Feature contained in the folder has the appropriate resources.


  • En règle générale, SharePoint Foundation garantit que les composants d’extension de la fonctionnalité d’interface utilisateur ne s’affichent pas dans les sites Web qui n’ont pas de ressources, mais il existe certaines exceptions.In general, SharePoint Foundation ensures that user interface extension components of the Feature do not show up in websites that do not have resources, but there are exceptions. Même si vous effectuez un travail prudent de définition de RequireResources et de ne pas déployer les définitions de site, sauf si toutes les fonctionnalités qu’ils disposent de ressources, fonctionnalités peuvent toujours afficher dans les sites où les ressources ne sont pas disponibles.Even if you do a careful job of setting RequireResources and not deploying site definitions unless all Features have resources in them, Features can still show up in sites where resources are not available.

    En tant qu’un exemple de scénario, supposez que vous disposez d’une fonctionnalité personnalisée avec les ressources pour les deux langues qui fournit des liens des paramètres de site et des boutons de barre d’outils personnalisée, et que vous avez mis en service une nouvelle collection de sites avec un site Web racine d’une des langues.As an example scenario, assume that you have a custom Feature with resources for two languages that provides custom toolbar buttons and site settings links, and that you have provisioned a new site collection with a root website in one of the languages. Puis, après le téléchargement et l’installation du pack de langue pour une langue tiers, vous mettez en service un nouveau sous-site dans cette troisième langue sous le site Web racine d’origine.Then, after downloading and installing the language pack for a third language, you provision a new subsite in this third language under the original root website. Si RequireResources n’est pas définie sur TRUE, la fonction personnalisée essaiera rattachées et l’utilisation des ressources de secours (en d’autres termes, les paramètres définis en tant que Resources\Resources.resx, aucune culture.) S’il n’y a aucune ressource de secours, Windows SharePoint Services seront affichés les chaînes vides.If RequireResources is not set to TRUE, the custom Feature will attempt to fall back and use fallback resources (in other words, those defined as Resources\Resources.resx, with no culture.) If there are no fallback resources, SharePoint Foundation will render empty strings. Toutefois, si RequireResources est défini sur TRUE, l’interface utilisateur des composants d’extension de la fonctionnalité (par exemple, ceux définis par le biais d’un élément CustomAction, ListTemplateou FeatureSiteTemplateAssociation ) apparaîtra pas dans les sous-sites si aucune ressource n’est disponible, afin que les paramètres de site et des liens personnalisés seront automatiquement masquées.However, if RequireResources is set to TRUE, user interface extension components of the Feature (for example, those defined through a CustomAction, ListTemplate, or FeatureSiteTemplateAssociation element) will not show up in subsites if no resources are available, so that the custom links and site settings will be automatically hidden.

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.Setting this attribute only applies to activating Features through the user interface, and not through STSADM.EXE command-line operations or the object model.

ScopeScope

Textobligatoire.Required Text. Spécifie l’étendue dans laquelle la fonctionnalité peut être activée et contient l’une des valeurs suivantes : batterie de serveurs (batterie), WebApplication (application Web), le Site (collection de sites), Web (site Web).Specifies the scope in which the Feature can be activated and contains one of the following values: Farm (farm), WebApplication (Web application), Site (site collection), Web (website). Pour plus d’informations sur l’étendue, voir Element Scope.For information about scope, see Element Scope.

SolutionIdSolutionId

Facultatif texte.Optional Text. Spécifie la solution à laquelle appartient la fonctionnalité.Specifies the solution to which the Feature belongs.

TitreTitle

Facultatif texte.Optional Text. Renvoie le titre de la fonctionnalité.Returns the title of the Feature. Limitée à 255 caractères.Limited to 255 characters.

UIVersionUIVersion

Facultatif texte.Optional Text. Spécifie la version de l’interface utilisateur de cette fonctionnalité.Specifies the user interface (UI) version for this Feature. UIVersion est spécifiée de plusieurs façons.UIVersion is specified in multiple ways.

  • =#-l’UIVersion du site doit être égale à #.=# - the site's UIVersion must be equal to #.

  • <# - the site's UIVersion must be less than #.

  • >#-l’UIVersion du site doit être supérieure à #.># - the site's UIVersion must be greater than #.

  • <=# - the site's UIVersion must be less than or equal to #.

  • >=#-l’UIVersion du site doit être supérieure ou égale à #.>=# - the site's UIVersion must be greater than or equal to #.

  • #;#-l’UIVersion du site doit se trouver dans la liste de nombres délimitée par des points-virgules.#;# - the site's UIVersion must be in the semicolon-delimited list of numbers.

VersionVersion

Facultatif texte.Optional Text. Spécifie un System.Version-conforme représentation de la version d’une fonctionnalité.Specifies a System.Version-compliant representation of the version of a Feature. Il peut s’agir jusqu'à quatre chiffres délimités par des décimales qui représentent une version.This can be up to four numbers delimited by decimals that represent a version.

Éléments enfantsChild elements

ActivationDependencies, ElementManifests, Propriétés, UpgradeActions, élément (Feature)ActivationDependencies, ElementManifests, Properties, UpgradeActions Element (Feature)

Éléments parentsParent elements

AucuneNone

RemarquesRemarks

Windows SharePoint Services prend en charge uniquement des caractères ASCII poids faible et sans espace, pour les noms de fichier et de dossier Feature.SharePoint Foundation supports only low-order ASCII characters, and no spaces, for Feature folder and file names.

ExempleExample

Pour obtenir un exemple de la façon dont cet élément est utilisé, voir Feature.xml Files.For an example of how this element is used, see Feature.xml Files.