<elemento linkedConfiguration>

Artigo
10/27/2023

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

<configuração>
<assemblyBinding>
<linkedConfiguration>

Sintaxe

<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 suportado para o atributo href é `file://`. Arquivos locais e arquivos UNC são suportados.

Elemento pai

Elemento	Descrição
<assemblyElemento Binding>	Especifica a política de vinculação de assembly no nível de configuração.

Elementos filho

Nenhuma

Observações

O <elemento linkedConfiguration> simplifica a manutenção de montagens de componentes. Se um ou mais aplicativos usarem um assembly que tenha um arquivo de configuração residindo 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 a montagem do componente é atendida, a atualização do arquivo de configuração comum fornece informações de configuração atualizadas para todos os aplicativos que usam a montagem.

Nota

O <elemento linkedConfiguration> não é suportado para 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 vinculação do carregador e são usadas somente pelo carregador. Os arquivos de configuração incluídos podem ter configurações diferentes de políticas de vinculação, mas essas configurações não têm qualquer efeito.
O único formato suportado para o href atributo é file://. Arquivos locais e arquivos UNC são suportados.
Não há restrição quanto ao 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 <elemento linkedConfiguration> é permitido somente em arquivos de configuração do aplicativo. Se o elemento aparecer em um arquivo Machine.config , ele será ignorado.
Não há nenhuma restrição sobre o conteúdo dos arquivos de configuração incluídos, desde que eles estejam em conformidade com o esquema do elemento assemblyBinding> pai<.
As referências circulares são detetadas e encerradas. Ou seja, se os <elementos linkedConfiguration> de uma série de arquivos de configuração formarem um loop, o loop será detetado 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>

Partilhar via