Elemento Feature (Característica)

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

<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"
  Version = "Text" >
</Feature>

Atributos

Atributo	Descripción
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 características en el ámbito de colecciones de sitios (Site) o sitios web (Web). En general, las características de ámbito de Farm se activan durante la instalación, y cuando se crea una nueva aplicación web, se activan todas las características de ámbito de Web application instaladas en ella.
AlwaysForceInstall	Boolean opcional. TRUE si la característica se instala a la fuerza durante la instalación incluso si la característica ya está instalada. Por ejemplo, si se establece como TRUE, las llamadas de instalación de características se activarán siempre que un usuario intente instalar la característica (incluso si ya está instalada) mediante la operación de la línea de comandos scanforfeatures o installfeature. Este atributo está establecido como FALSE de forma predeterminada. El atributo AlwaysForceInstall afecta a las características de todos los ámbitos.
AutoActivateInCentralAdmin	Boolean opcional. TRUE si la característica está activada de forma predeterminada en el sitio web de administración, colección de sitios o aplicación web. Este atributo está establecido como 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, Windows SharePoint Services busca de forma predeterminada en \12\TEMPLATE\FEATURES\FeatureName\Resources\Resources.<Culture>.resx. Sin embargo, si desea proporcionar un archivo de recursos principales compartido para todas las características de la aplicación, puede especificar un archivo alternativo a través del cual obtener acceso a los recursos mediante DefaultResourceFile. Por ejemplo, si establece DefaultResourceFile="MyFile", Windows SharePoint Services buscará en \12\Resources\MyFile.<Culture>.resx para recuperar recursos localizados para la característica.
Description	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 la dirección URL relativa del sitio de una imagen que se usa 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 Windows SharePoint Services compruebe si existen recursos para la característica comprobando que está presente el recurso de "centinela" estándar de dicha característica para una referencia cultural determinada. El archivo de recursos se denomina de acuerdo con el formato <Feature Directory>\Resources\Resources.<Culture Name>.resx, donde <Culture Name> es el nombre que identifica la referencia cultural. Windows SharePoint Services 3.0 admite los siguientes formatos para los nombres de referencia cultural: XX-XXX XX-XXXX-XX Ejemplos de nombres de referencia cultural: en-CA Inglés – Canadá fr-FR Francés – Francia ja-JP Japonés - Japón uz-Latn-UZ Uzbeko (Latino, Uzbekistán) uz-Cyrl-UZ Uzbeko (Cirílico, Uzbekistán) El formato de etiqueta de idioma Grupo de trabajo 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 indica un identificador de secuencia de comandos opcional. CC indica un identificador de región opcional. El atributo RequireResources permite restringir la visibilidad de ciertas características en función de si los recursos existen en un idioma determinado para la característica. Nota: Windows SharePoint Services no usa el archivo especificado por el atributo DefaultResourceFile, si existe, como archivo de copia de seguridad para comprobar la compatibilidad de una característica con un idioma determinado. Si el archivo no está presente para el idioma de un determinado sitio web o colección de sitios, entonces pueden producirse dos comportamientos: La característica quedará oculta en la interfaz de usuario para la activación de características en el sitio web o colección de sitios si los recursos correspondientes para el idioma no están disponibles. Tenga en cuenta que el atributo RequireResources se aplica sólo en la interfaz de usuario. Una característica sin recursos para un idioma determinado todavía se puede activar para un sitio web mediante operaciones de la línea de comandos con stsadm.exe o a través del modelo de objetos. Windows SharePoint Services no exige RequireResources para las características que forman parte de una definición de sitio más grande. Si, por ejemplo, se proporciona una versión tailandesa de una definición de sitio mediante la inclusión de webtempThai.xml en \12\TEMPLATE\1054\XML, se debe comprobar que todas las características contenidas en la carpeta tienen los recursos apropiados. En general, Windows SharePoint Services se asegura de que los componentes de extensión de la interfaz de usuario de la característica no se muestren en sitios web que no tienen recursos, pero hay excepciones. Incluso si tiene cuidado de establecer RequireResources y no implementar definiciones de sitio a menos que todas las características tengan recursos en ellas, las características pueden aparecer en sitios donde los recursos no están disponibles. Como un escenario de ejemplo, suponga que tiene una característica personalizada con recursos para dos idiomas que proporciona botones personalizados para una barra de herramientas y vínculos a la 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. A continuación, después de descargar e instalar el paquete de idioma para un tercer idioma, puede aprovisionar un nuevo subsitio en ese idioma bajo el sitio web raíz original. Si RequireResources no está establecido como TRUE, la característica personalizada intentará retroceder y usar recursos de reserva (en otras palabras, aquellos definidos como Resources\Resources.resx, sin referencia cultural). Si no hay recursos de reserva, Windows SharePoint Services representará cadenas vacías. Sin embargo, si RequireResources está establecido como TRUE, los componentes de extensión de la interfaz de usuario de la característica (por ejemplo, aquellos definidos mediante 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 quedarán ocultos automáticamente. Establecer este atributo sólo se aplica en la activación de características a través de la interfaz de usuario y no a través de operaciones de la línea de comandos STSADM.EXE o el modelo de objetos.
Scope	Text necesario. Especifica el ámbito en el que se puede activar la función y contiene uno de los siguientes valores: Farm (granja), WebApplication (aplicación web), Site (colección de sitios), Web (sitio web). Si desea más información sobre ese ámbito consulte Ámbito del elemento.
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.
Version	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

Elementos primarios

Ninguno

Comentarios

Windows SharePoint Services admite sólo caracteres ASCII de orden inferior, sin espacios, para nombres de archivo y carpeta de características.

Ejemplo

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