Elemento Feature (Recurso)

Aplica-se a: SharePoint 2016 | SharePoint Foundation 2013 | | do SharePoint Online SharePoint Server 2013

Define um recurso para ativar ou desativar em um escopo especificado.

Definição

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

As seções a seguir descrevem os atributos, os elementos filhos e os elementos pai.

Atributos

Atributo	Descrição
ActivateOnDefault	Booliano opcional. TRUE se o recurso for ativado por padrão durante a instalação ou quando um aplicativo Web for criado; FALSE se o recurso não estiver ativado. Esse atributo é igual a TRUE por padrão. O atributo ActivateOnDefault não se aplica à coleção de sites (Site) ou aos recursos de escopo do site (Web). Em geral, recursos com escopo farm são ativados durante a instalação e, quando um novo aplicativo Web é criado, todos os recursos instalados no escopo do aplicativo Web ficam ativados.
AlwaysForceInstall	Booliano opcional. TRUE se o Recurso for instalado à força durante a instalação, mesmo que o Recurso já esteja instalado. Por exemplo, se definido como TRUE, os manipuladores de eventos de implantação de recursos sempre serão acionados sempre que um usuário tentar instalar o Recurso (mesmo que já esteja instalado) usando a operação de linha de comando scanforfeatures ou installfeature . Esse atributo é igual a FALSE por padrão. O atributo AlwaysForceInstall afeta recursos de todos os escopos.
AutoActivateInCentralAdmin	Booliano opcional. TRUE se o Recurso for ativado por padrão no site administrativo, na coleção de sites ou no aplicativo Web. Esse atributo é igual a FALSE por padrão. O atributo AutoActivateInCentralAdmin não se aplica a recursos de escopo farm.
Creator	Texto opcional.
DefaultResourceFile	Texto opcional. Indica um arquivo de recurso comum para recuperar recursos XML do recurso. Se você não especificar um recurso no arquivo, o SharePoint Foundation procurará por padrão em %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATES\FEATURES\*FeatureName*\Resources\Resources._Culture_.resx. No entanto, se você quiser fornecer um arquivo de recurso principal compartilhado para todos os Recursos em seu aplicativo, você poderá especificar um arquivo alternativo por meio do qual acessar recursos usando DefaultResourceFile. Por exemplo, se você definir DefaultResourceFile="_MyFile_", o SharePoint Foundation examinará %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\Resources\*MyFile*._Culture_.resx para recuperar recursos localizados para seu Recurso.
Descrição	Cadeia de caracteres opcional. Retorna uma representação mais longa do que o Recurso faz.
Oculto	Booliano opcional. Esse atributo é igual a FALSE por padrão.
Id	Texto obrigatório. Contém o GUID (identificador globalmente exclusivo) para o Recurso.
Imageurl	Texto opcional. Contém uma URL relativa ao diretório \_layouts/IMAGES para uma imagem a ser usada para representar o Recurso na interface do usuário (interface do usuário).
ImageUrlAltText	Texto opcional. Contém o texto alternativo para a imagem que representa o Recurso.
ReceiverAssembly	Texto opcional. Se definido junto com ReceiverClass, especifica o nome forte do assembly assinado localizado no cache de assembly global do qual carregar um receptor para lidar com eventos de recurso.
ReceiverClass	Texto opcional. Se definido junto com ReceiverAssembly, especifica a classe que implementa o processador de eventos Feature.
RequireResources	Booliano opcional. TRUE para especificar se o SharePoint Foundation verifica se existem recursos para o Recurso verificando se o recurso "sentinela" padrão para o recurso está presente para uma cultura específica. O arquivo de recurso é nomeado de acordo com o formato <Feature Directory>\Resources\Resources..resx, em <Culture Name> que é o nome que identifica a cultura. O SharePoint Foundation dá suporte aos seguintes formatos para nomes de cultura: ll-CCll-Ssss-CC exemplos de nome da cultura: en-US English (Estados Unidos) de-DE German (Alemanha) fr-FR French (França) ja-JP Japonês (Japão) sr-Latn-CS Sérvio (Latino, Sérvia) O formato de marca de idioma IETF (Internet Engineering Task Force) é ll(l)-Ssss-CC, em que:* ll(l) denota o identificador de idioma de duas letras necessário (ou três letras, se não houver um código ISO de duas letras para o idioma). Ssss* denota um identificador de script opcional.* CC denota um identificador de região opcional. O atributo RequireResources permite restringir a visibilidade de determinados recursos, dependendo se há recursos em uma linguagem específica para o Recurso. Observação: o SharePoint Foundation não usará o arquivo especificado pelo atributo DefaultResourceFile, se houver um, como um arquivo de backup para verificar o suporte de um idioma específico para um recurso. Se o arquivo não estiver presente para o idioma de um determinado site ou coleção de sites, dois comportamentos poderão ocorrer: * O recurso estará oculto da interface do usuário para ativação de recursos no site ou na coleção de sites se os recursos correspondentes para o idioma não estiverem disponíveis. Tenha em mente que o atributo RequireResources é imposto apenas na interface do usuário. Um recurso sem recursos para um idioma específico ainda pode ser ativado para um site por meio de operações de linha de comando com stsadm.exe ou por meio do modelo de objeto. O SharePoint Foundation não impõe RequireResources para recursos que fazem parte de uma definição de site maior. Se você fornecer, por exemplo, uma versão tailandesa de uma definição de site colocando um webtempThai.xml em %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\1054\XML, você deve verificar se cada recurso contido na pasta tem os recursos apropriados. * Em geral, o SharePoint Foundation garante que os componentes de extensão da interface do usuário do Recurso não apareçam em sites que não têm recursos, mas há exceções. Mesmo que você faça um trabalho cuidadoso de definir RequireResources e não implantar definições de site, a menos que todos os recursos tenham recursos neles, os recursos ainda podem aparecer em sites em que os recursos não estão disponíveis. Como um cenário de exemplo, suponha que você tenha um recurso personalizado com recursos para dois idiomas que fornece botões de barra de ferramentas personalizados e links de configurações de site e que você provisionou uma nova coleção de sites com um site raiz em um dos idiomas. Em seguida, depois de baixar e instalar o pacote de idiomas para um terceiro idioma, você provisionará um novo subsite neste terceiro idioma no site raiz original. Se RequireResources não estiver definido como TRUE, o recurso personalizado tentará recuar e usar recursos de fallback (em outras palavras, aqueles definidos como Resources\Resources.resx, sem cultura.) Se não houver recursos de fallback, o SharePoint Foundation renderizará cadeias de caracteres vazias. No entanto, se RequireResources for definido como TRUE, os componentes de extensão da interface do usuário do Recurso (por exemplo, aqueles definidos por meio de um elemento CustomAction, ListTemplate ou FeatureSiteTemplateAssociation) não aparecerão em subsites se nenhum recurso estiver disponível, de modo que os links personalizados e as configurações do site serão automaticamente ocultos. Definir esse atributo só se aplica à ativação de Recursos por meio da interface do usuário e não por meio de operações de linha de comando STSADM.EXE ou do modelo de objeto.
Escopo	Texto obrigatório. Especifica o escopo no qual o Recurso pode ser ativado e contém um dos seguintes valores: Farm (farm), WebApplication (aplicativo Web), Site (conjunto de sites), Web (site). Para obter informações sobre escopo, consulte Escopo do Elemento.
Solutionid	Texto opcional. Especifica a solução à qual o Recurso pertence.
Título	Texto opcional. Retorna o título do Recurso. Limitado a 255 caracteres.
UIVersion	Texto opcional. Especifica a versão da interface do usuário (interface do usuário) para este recurso. A UIVersion é especificada de várias maneiras. * =# - a UIVersion do site deve ser igual a #. <#* - a UIVersion do site deve ser menor que #.* ># - a UIVersion do site deve ser maior que #.<=#* - a UIVersion do site deve ser menor ou igual a #.* >=# - a UIVersion do site deve ser maior ou igual a #. * #;# - a UIVersion do site deve estar na lista delimitada por ponto-e-vírgula de números.
Versão	Texto opcional. Especifica uma representação compatível com System.Version da versão de um recurso. Isso pode ser até quatro números delimitados por decimais que representam uma versão.

Elementos filho

Elemento ActivationDependencies, ElementManifests, Properties, UpgradeActions Element (Feature)

Elementos pai

Nenhum

Comentários

O SharePoint Foundation dá suporte apenas a caracteres ASCII de baixa ordem e sem espaços para nomes de pasta e arquivo de recurso.

Exemplo

Para obter um exemplo de como esse elemento é usado, consulte Feature.xml Arquivos.