elemento <linkedConfiguration>

Especifica um ficheiro de configuração a incluir.

<configuration>
  <assemblyBinding>
    <linkedConfiguration>

Sintaxe

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

Attribute

Elemento pai

Elementos filho

Nenhum

Observações

O <linkedConfiguration> elemento simplifica a manutenção dos conjuntos de componentes. Se uma ou mais aplicações usarem um assembly que tenha um ficheiro de configuração num local bem conhecido, os seus ficheiros de configuração podem usar o <linkedConfiguration> elemento para incluir o ficheiro de configuração assembly, em vez de duplicarem informação de configuração. Quando o conjunto do componente é servido, atualizar o ficheiro de configuração comum fornece informação de configuração atualizada a todas as aplicações que utilizam o conjunto.

As seguintes regras regem a utilização de ficheiros de configuração ligados:

• As definições nos ficheiros de configuração incluídos afetam apenas a política de ligação do carregador e são usadas apenas pelo carregador. Os ficheiros de configuração incluídos podem ter definições além de políticas de ligação, mas essas definições não têm qualquer efeito.

• O único formato suportado para o href atributo é file://. São suportados ficheiros locais e UNC.

• Não há restrição ao número de configurações ligadas por ficheiro de configuração.

• Todos os ficheiros de configuração ligados são fundidos para formar um único ficheiro de configuração assembly, semelhante ao comportamento da #include diretiva em C/C++.

• O <linkedConfiguration> elemento é permitido apenas nos ficheiros de configuração da aplicação. Se o elemento aparecer num ficheiroMachine.config , é ignorado.

• Não há restrições quanto ao conteúdo dos ficheiros de configuração incluídos, desde que cumpram o esquema do elemento pai <assemblyBinding> .

• As referências circulares são detetadas e terminadas. Ou seja, se os <linkedConfiguration> elementos de uma série de ficheiros de configuração formarem um ciclo, o ciclo é detetado e parado.

Example

O exemplo seguinte mostra como incluir ficheiros de configuração a partir 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 ficheiro de configuração para o .NET Framework