Elemento Feature (Característica)

Se aplica a: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Define una característica para activar o desactivar en un ámbito especificado.

Definición

<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>

Elementos y atributos

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.

Atributos

Atributo	Description
ActivateOnDefault	Boolean opcional. TRUE si la característica está activada de forma predeterminada durante la instalación o cuando se crea una aplicación web; FALSE si la característica no está activada. Este atributo es TRUE de forma predeterminada. El atributo ActivateOnDefault no se aplica a las características con ámbito de colección de sitios (sitio) o sitio web (web). En general, las características con ámbito de granja de servidores se activan durante la instalación y, cuando se crea una nueva aplicación web, se activan todas las características de ámbito de aplicación web instaladas en ella.
AlwaysForceInstall	Boolean opcional. TRUE si se fuerza la instalación de la característica durante la instalación aunque ya esté instalada. Por ejemplo, si se establece en TRUE, los controladores de eventos de implementación de características siempre se activarán cada vez que un usuario intente instalar la característica (incluso si ya está instalada) mediante la operación de línea de comandos scanforfeatures o installfeature . Este atributo es igual a FALSE de forma predeterminada. El atributo AlwaysForceInstall afecta a las características de todos los ámbitos.
AutoActivateInCentralAdmin	Boolean opcional. TRUE si la característica se activa de forma predeterminada en el sitio web administrativo, la colección de sitios o la aplicación web. Este atributo es igual a FALSE de forma predeterminada. El atributo AutoActivateInCentralAdmin no se aplica a características de ámbito de Farm.
Creator	Text opcional.
DefaultResourceFile	Text opcional. Indica un archivo de recursos comunes para recuperar recursos XML de características. Si no especifica un recurso en el archivo, SharePoint Foundation busca de forma predeterminada en %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATES\FEATURES\*FeatureName*\Resources\Resources._Culture_.resx. Sin embargo, si desea proporcionar un archivo de recursos de núcleo compartido para todas las características de la aplicación, puede especificar un archivo alternativo a través del cual acceder a los recursos mediante DefaultResourceFile. Por ejemplo, si establece DefaultResourceFile="_MyFile_", SharePoint Foundation busca en %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\Resources\*MyFile*._Culture_.resx para recuperar los recursos localizados de la característica.
Descripción	String opcional. Devuelve una representación más larga de lo que hace la característica.
Hidden	Boolean opcional. Este atributo es igual a FALSE de forma predeterminada.
Id	Text obligatorio. Contiene el identificador único global (GUID) de la característica.
Imageurl	Text opcional. Contiene una dirección URL relativa al directorio \_layouts/IMAGES para que una imagen se use para representar la característica en la interfaz de usuario (UI).
ImageUrlAltText	Text opcional. Contiene el texto alternativo para la imagen que representa la característica.
ReceiverAssembly	Text opcional. Si se establece junto con ReceiverClass, especifica el nombre seguro del ensamblado firmado ubicado en la memoria caché de ensamblados global desde la que se carga un receptor para controlar los eventos de la característica.
ReceiverClass	Text opcional. Si se establece junto con ReceiverAssembly, especifica la clase que implementa el procesador de eventos de características.
RequireResources	Boolean opcional. TRUE para especificar que SharePoint Foundation compruebe si existen recursos para la característica comprobando que el recurso estándar "sentinel" de la característica está presente para una referencia cultural determinada. El archivo de recursos se denomina según el formato <Feature Directory>\Resources\Resources..resx, donde <Culture Name> es el nombre que identifica la referencia cultural. SharePoint Foundation admite los siguientes formatos para nombres de referencia cultural: ll-CC ll-Ssss-CC Ejemplos de nombre de referencia cultural: en-US Inglés (Estados Unidos) de-DE Alemán (Alemania) francés fr-FR (Francia) ja-JP Japonés (Japón) sr-Latn-CS Serbio (latino, Serbia) El formato de etiqueta de idioma del Grupo de tareas de ingeniería de Internet (IETF) es ll(l)-Ssss-CC, donde:* ll(l) indica el identificador de idioma de dos letras necesario (o tres letras si no hay código ISO de dos letras para el idioma). Ssss* Denota un identificador de script opcional.* CC Denota un identificador de región opcional. El atributo RequireResources permite restringir la visibilidad de determinadas características en función de si los recursos existen en un idioma determinado para la característica. Nota: SharePoint Foundation no usa el archivo especificado por el atributo DefaultResourceFile, si hay uno, como un archivo de copia de seguridad para comprobar la compatibilidad de un idioma determinado para una característica. Si el archivo no está presente para el idioma de un sitio web o colección de sitios determinados, pueden producirse dos comportamientos: * La característica se ocultará de la interfaz de usuario para la activación de Características en el sitio web o la colección de sitios si los recursos correspondientes para el idioma no están disponibles. Tenga en cuenta que el atributo RequireResources solo se aplica en la interfaz de usuario. Una característica sin recursos para un idioma determinado todavía se puede activar para un sitio web a través de operaciones de línea de comandos con stsadm.exe o a través del modelo de objetos. SharePoint Foundation no aplica RequireResources para las características que forman parte de una definición de sitio más grande. Si proporciona, por ejemplo, una versión tailandesa de una definición de sitio colocando un webtempThai.xml en %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\1054\XML, debe comprobar que cada característica contenida en la carpeta tiene los recursos adecuados. * En general, SharePoint Foundation garantiza que los componentes de extensión de interfaz de usuario de la característica no se muestren en sitios web que no tienen recursos, pero hay excepciones. Incluso si realiza un trabajo cuidadoso al establecer RequireResources y no implementar definiciones de sitio a menos que todas las características tengan recursos en ellas, las características todavía se pueden mostrar en sitios donde los recursos no están disponibles. Como escenario de ejemplo, suponga que tiene una característica personalizada con recursos para dos idiomas que proporciona botones de barra de herramientas personalizados y vínculos de configuración del sitio, y que ha aprovisionado una nueva colección de sitios con un sitio web raíz en uno de los idiomas. Después, después de descargar e instalar el paquete de idioma para un tercer idioma, aprovisiona un nuevo subsitio en este tercer idioma en el sitio web raíz original. Si RequireResources no está establecido en TRUE, la característica personalizada intentará revertir y usar recursos de reserva (es decir, los definidos como Resources\Resources.resx, sin referencia cultural). Si no hay recursos de reserva, SharePoint Foundation representará cadenas vacías. Sin embargo, si RequireResources se establece en TRUE, los componentes de extensión de interfaz de usuario de la característica (por ejemplo, los definidos a través de un elemento CustomAction, ListTemplate o FeatureSiteTemplateAssociation) no se mostrarán en subsitios si no hay recursos disponibles, de modo que los vínculos personalizados y la configuración del sitio se ocultarán automáticamente. Establecer este atributo solo se aplica a la activación de características a través de la interfaz de usuario y no a través de STSADM.EXE operaciones de línea de comandos o el modelo de objetos.
Scope	Text obligatorio. Especifica el ámbito en el que se puede activar la característica y contiene uno de los siguientes valores: Granja (granja), Aplicación web (aplicación web), Sitio (colección de sitios), Web (sitio). Si desea más información sobre ese ámbito consulte Element Scope.
SolutionId	Text opcional. Especifica la solución a la que pertenece la característica.
Title	Text opcional. Devuelve el título de la característica. Limitada a 255 caracteres.
UIVersion	Text opcional. Especifica la versión de interfaz de usuario para esta característica. UIVersion se especifica de varias maneras. * =# - La UIVersion del sitio debe ser igual a #. <#* - La UIVersion del sitio debe ser menor que #.* ># - La UIVersion del sitio debe ser mayor que #.<=#* - La UIVersion del sitio debe ser menor o igual que #.* >=# - La UIVersion del sitio debe ser mayor o igual que #. * #;# - La UIVersion del sitio debe estar en la lista de números delimitada por punto y coma.
Versión	Text opcional. Especifica una representación compatible con System.Version de la característica. Puede estar compuesta por hasta cuatro números delimitados por decimales que representan una versión.

Elementos secundarios

ActivationDependencies, ElementManifests, Properties, UpgradeActions Element (Feature)

Elementos principales

Ninguno

Comentarios

SharePoint Foundation solo admite caracteres ASCII de orden bajo y sin espacios para los nombres de archivo y carpeta de características.

Ejemplo

Para obtener un ejemplo de cómo se usa este elemento, vea Feature.xml Files.