Partilhar via

elemento <linkedConfiguration>

Especifica um ficheiro de configuração a incluir.

<configuration>
  <assemblyBinding>
    <linkedConfiguration>

Sintaxe

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

Attribute

Attribute Description
href Atributo obrigatório.

O URL do ficheiro de configuração a incluir. O único formato suportado para o href atributo é file://. São suportados ficheiros locais e UNC.

Elemento pai

Elemento Description
<assemblyBinding> Especifica a política de ligação de montagem ao nível de configuração.

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.

Observação

O <linkedConfiguration> elemento não é suportado para aplicações com manifestos lado a lado do Windows.

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

  • Last updated on