Condividi tramite


Elemento <linkedConfiguration>

Specifica un file di configurazione da includere.

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

Attributi ed elementi

Nelle sezioni seguenti vengono illustrati attributi, elementi figlio e padre.

Attributi

Attributo

Descrizione

href

URL del file di configurazione da includere. L'unico formato supportato per l'attributo href è "file://". Sono supportati i file locali e i file UNC.

Elementi figlio

Nessuno.

Elementi padre

Elemento

Oggetto di descrizione

Elemento <assemblyBinding> per <configuration>

Specifica i criterio di associazione degli assembly al livello di configurazione.

Note

L'elemento <linkedConfiguration> semplifica la gestione degli assembly del componente. Se una o più applicazioni utilizzano un assembly il cui file di configurazione è contenuto in un percorso noto, i file di configurazione delle applicazioni che utilizzano l'assembly possono utilizzare l'elemento <linkedConfiguration> per includere il file di configurazione dell'assembly, anziché direttamente le informazioni di configurazione. Quando viene eseguita la gestione dell'assembly del componente, è sufficiente aggiornare il file di configurazione comune per fornire informazioni di configurazione aggiornate a tutte le applicazioni in cui viene utilizzato l'assembly.

NotaNota

L'elemento <linkedConfiguration> non è supportato per le applicazioni con manifesti di Windows affiancati.

L'utilizzo dei file di configurazione collegati è controllato dalle regole riportate di seguito.

  • Le impostazioni contenute nei file di configurazione inclusi hanno effetto solo sui criteri di associazione del caricatore e vengono utilizzate solo dal caricatore. Nei file di configurazione inclusi possono essere contenute impostazioni diverse dai criteri di associazione, ma tali impostazioni non producono alcun effetto.

  • L'unico formato supportato per l'attributo href è "file://". Sono supportati i file locali e i file UNC.

  • Non esistono limiti per il numero delle configurazioni collegate per file di configurazione.

  • Tutti i file di configurazione collegati vengono uniti per formare un file, analogamente al comportamento della direttiva #include in C/C++.

  • L'elemento <linkedConfiguration> è supportato solo dai file di configurazione dell'applicazione. Viene ignorato in Machine.config.

  • I riferimenti circolari vengono rilevati e terminati, ovvero se gli elementi <linkedConfiguration> di una serie di file di configurazione formano un ciclo, il ciclo viene rilevato e arrestato.

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come includere un file di configurazione dal disco rigido locale.

<configuration>
   <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <linkedConfiguration href="file://c:\Program Files\Contoso\sharedConfig.xml"/>
   </assemblyBinding>
</configuration>

Vedere anche

Riferimenti

Elemento <assemblyBinding> per <configuration>

Altre risorse

Schema dei file di configurazione per .NET Framework