<linkedConfiguration> Elemento

Especifica um arquivo de configuração para incluir.

<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 href atributo é "file://". Há suporte para arquivos locais e UNC.

Elementos filho

Nenhum.

Elementos pai

Elemento

Descrição

<assemblyBinding> Elemento para <configuration>

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

Comentários

O <linkedConfiguration> elemento simplifica a manutenção de módulos (assemblies) do componente. 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 do assembly, em vez de incluindo informações de configuração diretamente. Quando o assembly do componente é atendido, atualizar o arquivo de configuração comuns fornece informações de configuração atualizada para todos os aplicativos que usam o assembly.

Observação

O <linkedConfiguration> elemento não é suportado 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 ligação do carregador e são usadas somente pelo carregador do. Os arquivos de configuração incluídos podem ter outras configurações de diretivas de ligação, mas essas configurações não têm qualquer 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 vinculada serão mesclados para formar um arquivo, semelhante ao comportamento da #include diretiva em C / C++.

  • O <linkedConfiguration> elemento só é permitido em arquivos de configuração do aplicativo; ele é ignorado em Machine. config.

  • Referências circulares são detectadas e finalizadas. Ou seja, se a <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 <configuration>

Outros recursos

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