Elemento <linkedConfiguration>
Aggiornamento: novembre 2007
Specifica un file di configurazione da includere.
Elemento <Configuration>
Elemento <assemblyBinding> per <configuration>
Elemento <linkedConfiguration>
<linkedConfiguration
href="URL of linked configuration file"/>
Attributi ed elementi
Nelle sezioni riportate di seguito vengono illustrati attributi, elementi figlio ed elementi 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 |
Descrizione |
|---|---|
Specifica il 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.
Nota
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>