Elemento <linkedConfiguration>

  • Artigo

Especifica um arquivo de configuração a ser incluído.

<configuration>
  <assemblyBinding>
    <linkedConfiguration>

Syntax

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

Atributo

Atributo Descrição
href Atributo obrigatório.

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

Elemento pai

Elemento Descrição
<Elemento assemblyBinding> Especifica a diretiva de ligação de assembly no nível de configuração.

Elementos filho

Nenhum

Comentários

O elemento <linkedConfiguration> simplifica a manutenção para assemblies de componente. Se um ou mais aplicativos usarem um assembly que tenha um arquivo de configuração que resida em um local conhecido, seus arquivos de configuração poderão usar o elemento <linkedConfiguration> para incluir o arquivo de configuração do assembly, em vez de duplicar as informações de configuração. Quando o assembly de componente recebe manutenção, a atualização do arquivo de configuração comum fornece informações de configuração atualizadas para todos os aplicativos que usam o assembly.

Observação

O elemento <linkedConfiguration> não tem suporte para os aplicativos com manifestos lado a lado do Windows.

As regras a seguir regem o uso de arquivos de configuração vinculados:

  • As configurações nos arquivos de configuração incluídos afetam apenas a política de associação do carregador e são usadas apenas pelo carregador. Os arquivos de configuração incluídos podem ter configurações diferentes de políticas de associação, mas essas configurações não têm nenhum efeito.

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

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

  • Todos os arquivos de configuração vinculados são mesclados para formar um arquivo de configuração de assembly, semelhante ao comportamento da diretiva #include em C/C++.

  • O elemento >linkedConfiguration< é permitido somente nos arquivos de configuração de aplicativo. Se o elemento aparecer em um arquivo Machine.config, ele será ignorado.

  • Não há restrições no conteúdo dos arquivos de configuração incluídos, desde que estejam em conformidade com o esquema do elemento <assemblyBinding> pai.

  • As referências circulares são detectadas e encerradas. Ou seja, se os elementos <linkedConfiguration> de uma série de arquivos de configuração formarem um loop, o loop será detectado e interrompido.

Exemplo

O exemplo a seguir mostra como incluir o arquivo de configuração de um disco rígido local:

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

Confira também