<linkedConfiguration> elemento

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

<configuration>
  <assemblyBinding>
    <linkedConfiguration>

Sintaxe

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

Attribute

Elemento pai

Elementos filho

None

Observações

O <linkedConfiguration> elemento 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 <linkedConfiguration> elemento para incluir o arquivo de configuração do assembly, em vez de duplicar informações de configuração. Quando o assembly de componente é atendido, a atualização do arquivo de configuração comum fornece informações de configuração atualizadas para todos os aplicativos que usam o assembly.

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 href atributo é file://. Há suporte para arquivos locais e 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 vinculados são mesclados para formar um arquivo de configuração de assembly, semelhante ao comportamento da #include diretiva em C/C++.

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

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

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

Example

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>

Consulte também

• <assemblyBinding> Elemento
• Esquema de arquivo de configuração para o .NET Framework