Partilhar via


Elemento <linkedconfiguration>

Especifica um arquivo de configuração para incluir.

<configuration> Element
  <assemblybinding>Elemento para <configuração>
    Elemento <linkedconfiguration>

<linkedConfiguration
   href="URL of linked configuration file"/>

Atributos e elementos

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

Atributos

Atributo

Descrição

href

A URL do arquivo de configuração que deve ser incluído. O único formato com suporte para o hrefo atributo é "arquivo://". Há suporte para arquivos locais e arquivos UNC.

Elementos filho

Nenhum.

Elementos pai

Elemento

Descrição

<assemblybinding>Elemento para <configuração>

Especifica a diretiva de associação de assembly no nível de configuração.

Comentários

The <linkedConfiguration> elemento simplifica a manutenção de conjuntos de componentes. Se um ou mais aplicativos usam um conjunto que possui um arquivo de configuração que residem em um local conhecido, os arquivos de configuração dos aplicativos que usam o assembly podem usar o <linkedConfiguration> elemento para incluir o arquivo de configuração de assembly, em vez de incluindo informações de configuração diretamente. Quando o conjunto do componente é atendido, atualizar o arquivo de configuração comuns fornece informações de configuração atualizada para todos os aplicativos que usam o conjunto.

ObservaçãoObservação:

O <linkedConfiguration> Não há suporte para o elemento para aplicativos com manifestos do Windows lado a lado.

As seguintes regras regem o uso de arquivos de configuração vinculada.

  • As configurações em arquivos de configuração incluído somente afetam a diretiva de associação do carregador e são usadas somente pelo carregador do. Os arquivos de configuração incluído podem ter configurações diferentes de diretivas de ligação, mas essas configurações não têm qualquer efeito.

  • O único formato com suporte para o hrefo atributo é "arquivo://". Há suporte para arquivos locais e arquivos UNC.

  • Não há nenhuma restrição no número de configurações vinculadas por arquivo de configuração.

  • Todos os arquivos de configuração vinculada são mesclados para formulário um arquivo, semelhante ao comportamento do #include diretiva em C/C ++.

  • The <linkedConfiguration> o elemento é permitido somente em arquivos de configuração do aplicativo; ela será ignorada em computador.config.

  • Referências circulares são detectadas e finalizadas. Ou seja, se o <linkedConfiguration> elementos de uma série de arquivos de configuração formam um loop, loop é detectado e interrompido.

Exemplo

O exemplo de código a seguir mostra como incluir o arquivo de configuração do disco rígido local.

<configuration>
   <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <linkedConfiguration href="file://c:\Program Files\Contoso\sharedConfig.xml"/>
   </assemblyBinding>
</configuration>

Consulte também

Referência

<assemblybinding>Elemento para <configuração>

Outros recursos

Esquema do arquivo de configuração para o .NET Framework