Compartir a través de

Elemento Feature (Característica)

  • Artículo

Última modificación: viernes, 28 de enero de 2011

Hace referencia a: SharePoint Foundation 2010

En este artículo
Atributos
Elementos secundarios
Elementos primarios

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"
  UIVersion = "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 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 la implementació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 en 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, SharePoint Foundation busca de manera predeterminada en %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATES\FEATURES\nombreDeCaracterística\Resources\Resources. referenciaCultural.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="miArchivo", SharePoint Foundation buscará en %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\Resources\miArchivo. referenciaCultural.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 una dirección URL relativa al directorio /_layouts/IMAGES de una imagen que se usa para representar la característica en la interfaz de usuario.

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 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 <Directorio de característica>\Resources\Resources. <Nombre de referencia cultural>.resx, donde <Nombre de referencia cultural> es el nombre que identifica la referencia cultural. SharePoint Foundation admite los siguientes formatos para los nombres de referencia cultural:

ll-CC

ll-Ssss-CC

Ejemplos de nombres de referencia cultural:

en-US inglés (Estados Unidos)

de-DE alemán (Alemania)

fr-FR francés (Francia)

ja-JP japonés (Japón)

sr-Latn-CS serbio (latino, Serbia)

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.

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.

    SharePoint Foundation 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 %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\1054\XML, se debe comprobar que todas las características contenidas en la carpeta tienen los recursos apropiados.

  • En general, SharePoint Foundation 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 de la 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, SharePoint Foundation 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.

UIVersion

Text opcional. Especifica la versión de interfaz de usuario para esta característica. La propiedad UIVersion se especifica de varias formas.

  • =# - la propiedad UIVersion del sitio debe ser igual a #.

  • <# - la propiedad UIVersion del sitio debe ser menor que #.

  • ># - la propiedad UIVersion del sitio debe ser mayor que #.

  • <=# - la propiedad UIVersion del sitio debe ser menor o igual a #.

  • >=# - la propiedad UIVersion del sitio debe ser mayor o igual a #.

  • #;# - la propiedad UIVersion del sitio debe ser la lista de números delimitada por punto y coma.

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, Elemento UpgradeActions (Feature)

Elementos primarios

Ninguno

Comentarios

SharePoint Foundation 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.