Compartilhar via


Elemento recurso (recurso)

Define um recurso para ativar ou desativar em um escopo 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 Descrição

ActivateOnDefault

Opcional Boolean. TRUE se o recurso for Por padrão ativado durante a instalação ou quando é criado um aplicativo da Web; FALSE se o recurso não está ativado. Esse atributo é igual a TRUE Por padrão. O atributo ActivateOnDefault ActivateOnDefault não aplicar a coleção site ( Site) ou site ( Web) escopo recursos.

Em geral, Farm Farm - recursos do escopo se tornam ativados durante instalação e quando um novo aplicativo da Web é criado, todos instalado Web application - recursos do escopo nela ficarem ativados.

AlwaysForceInstall

Opcional Boolean. TRUE se o recurso é instalado por forçar durante instalação mesmo se o recurso já está instalado. De exemplo, se definido como TRUE, recurso instalação textos explicativos será sempre acionar a qualquer momento um usuário tenta instalar o recurso (mesmo se ele já estiver instalado) usando o scanforfeatures ou installfeature installfeature linha de comando operação. Esse atributo é igual a FALSE Por padrão. O atributo AlwaysForceInstall AlwaysForceInstall afeta recursos de todos os escopos.

AutoActivateInCentralAdmin

Opcional Boolean. TRUE se o recurso está ativado Por padrão no site administrativo, coleção site ou aplicativo da Web. Esse atributo é igual a FALSE Por padrão. O atributo AutoActivateInCentralAdmin AutoActivateInCentralAdmin não aplicar a Farm-escopo recursos.

Creator

Opcional Text.

DefaultResourceFile

Opcional Text. Indica um comum arquivo recurso para recuperar os recursos Feature XML. If you do not specify a resource in the file, Windows SharePoint Services looks by default in \12\TEMPLATE\FEATURES\FeatureName\Resources\Resources.<Culture>.resx. No entanto, se você desejar fornecer um arquivo recurso núcleo compartilhados para todos os recursos do seu aplicativo, você pode especificar um alternativo arquivo através do qual a acessar recursos usando DefaultResourceFile. For example, if you set DefaultResourceFile="MyFile", Windows SharePoint Services looks in \12\Resources\MyFile.<Culture>.resx to retrieve localized resources for your Feature.

Description

Opcional String. Retorna uma representação mais do que o recurso faz.

Hidden

Opcional Boolean. Esse atributo é igual a FALSE Por padrão.

Id

Necessário Text. Contém a identificador exclusivo (GUID) para o recurso.

ImageUrl

Opcional Text. Contém o site-URL relativa para uma imagem para usar para representar o recurso na interface de usuário (interface do usuário).

ImageUrlAltText

Opcional Text. Contém o texto alternativo para a imagem que representa o recurso.

ReceiverAssembly

Opcional Text. Se definir juntamente com ReceiverClass, especifica a nome forte do assinado assembly localizado na cache global de assemblies a partir da qual carregar um receptor para identificador recursos eventos.

ReceiverClass

Opcional Text. Se definir juntamente com ReceiverAssembly, especifica a classe que implementa o processador evento de recursos.

RequireResources

Opcional Boolean. TRUE para especificar que verificar Windows SharePoint Services se existem recursos para o recurso Verificando que o padrão "Sentinel" recurso para o recurso está presente para uma cultura específica.

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. Suporta Windows SharePoint Services 3.0 wssversion3short o seguinte formatos para cultura nomes:

XX-xxx

XXXX-xx-xx

Cultura nome Exemplos:

en-CA inglês \endash Canadá

Fr-fr fr-FR Francês \endash França

ja-JP japonês - Japonês

uz-Latn-UZ Uzbeque (Latin, Uzbekistan)

uz-Cyrl-UZ Uzbeque (Cyrillic, Uzbekistan)

O formato marca linguagem IETF (IETF) é Tudo ll(l)-Ssss-CC, onde:

  • ll(l) denota o exigido dois-identificador linguagem letra (ou três - letra se não houver nenhuma ISO duas - codificar letra para a linguagem).

  • Ssss denota um opcional identificador script.

  • CC denota um opcional identificador de região.

O atributo RequireResources RequireResources permite que você constrict a visibilidade de certos recursos, dependendo se recursos existem em uma linguagem específica para o recurso.

Observação

Os serviços SharePoint Windows não usa o arquivo especificado pelo atributo DefaultResourceFile DefaultResourceFile, se houver, como um arquivo de backup para verificar suporte de uma linguagem específica de um recurso.

Se o arquivo não está presente para a linguagem de um determinado site ou site coleção, dois comportamentos podem ocorrer:

  • O recurso ficará oculta da interface de usuário para ativação de recursos na coleção de site ou site se o correspondente não são recursos para a linguagem disponível.

    Tenha em mente que o atributo RequireResources RequireResources será aplicado a interface usuário somente. Um recurso sem recursos para uma determinada linguagem ainda pode ser ativado para um site ou através de operações linha de comando com Stsadm.exe modelo de objeto.

    Windows SharePoint serviços faz não aplicar RequireResources para recursos que fazem parte de um maior definição site. Se você fornecer, de exemplo, uma versão de uma definição site colocando um webtempThai.xml em \12\TEMPLATE\1054\XML tailandês, você deve verificar que cada recurso contido a pasta possui o apropriado recursos.

  • Em geral, os serviços SharePoint Windows garante que usuário interface extensão componentes do recurso não apresentação Backup no Web sites que não tem recursos, mas há exceções. Mesmo se você fazer um trabalho cuidadoso de configuração RequireResources e não implantando definições site a menos que todos os recursos tem recursos neles contidos, recursos podem ainda apresentação backup nos sites onde recursos não estão disponível.

    Como um cenário exemplo, suponha que você tenha um personalizado de recursos com recursos para dois idiomas que fornece personalizado botões barra de ferramentas e site configurações links, e que você tiver configurado uma nova coleção site com um site raiz em um dos idiomas. Em seguida, após o download e instalar o pacote linguagem para uma linguagem terceira, você configurar um novo subsite nessa linguagem terceira sob o original site raiz. 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, Windows SharePoint Services will render empty strings. 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.

Configurando este atributo se aplica somente a ativar recursos a interface de usuário e não através de linha de comando STSADM.EXE o modelo de objeto ou operações.

Scope

Necessário Text. 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 (Web site). Para obter informações sobre escopo, consulte Elemento escopo.

SolutionId

Opcional Text. Especifica a solução ao qual o recurso pertence.

Title

Opcional Text. Retorna o título do recurso. Limitado a 255 caracteres.

Version

Opcional Text. Especifica um System.Version-compatível representação da versão de um recurso. Isso pode ser até quatro números delimitados por casas decimais que representam uma versão.

Elementos filho

ActivationDependencies, ElementManifests, propriedades

Elementos pai

Nenhum

Comentários

Baixa apenas oferece suporte a serviços SharePoint Windows-ordem ASCII caracteres e sem espaços, para nomes de pasta e arquivo de recursos.

Exemplo

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