<linkedConfiguration> (élément)

Spécifie un fichier de configuration à inclure.

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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Éléments enfants

Aucun

Éléments parents

Notes

L'élément <linkedConfiguration> simplifie la maintenance pour les assemblys de composants. Si une ou plusieurs applications utilisent un assembly disposant d'un fichier de configuration qui réside dans un emplacement connu, les fichiers de configuration des applications qui utilisent l'assembly peuvent utiliser l'élément <linkedConfiguration> pour inclure le fichier de configuration d'assembly, plutôt qu'inclure les informations de configuration directement. Lorsque l'assembly de composant est traité, la mise à jour du fichier de configuration commun fournit des informations de configuration mises à jour à toutes les applications qui utilisent l'assembly.

Remarque
L'élément <linkedConfiguration> n'est pas pris en charge pour les applications avec des manifestes côte à côte Windows.

Les règles suivantes déterminent l'utilisation de fichiers de configuration liés.

• Les paramètres des fichiers de configuration inclus affectent uniquement la stratégie de liaison du chargeur et sont utilisés uniquement par le chargeur. Les fichiers de configuration inclus peuvent disposer de paramètres autres que les stratégies de liaison, mais ces paramètres n'ont aucun effet.

• Le seul format pris en charge pour l'attribut href est « file:// ». Les fichiers locaux et les fichiers UNC sont pris en charge.

• Il n'existe aucune contrainte quant au nombre de configurations liées par fichier de configuration.

• Tous les fichiers de configuration liés sont fusionnés pour former un fichier, semblable au comportement de la directive #include en C/C++.

• L'élément <linkedConfiguration> est autorisé uniquement dans les fichiers de configuration de l'application ; il est ignoré dans Machine.config.

• Les références circulaires sont détectées et arrêtées. Autrement dit, si les éléments <linkedConfiguration> d'une série de fichiers de configuration forment une boucle, la boucle est détectée et arrêtée.

Exemple

L'exemple de code suivant indique comment inclure un fichier de configuration à partir du disque dur local.

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

Voir aussi

Référence

<assemblyBinding>, élément de <configuration>

Autres ressources

Schéma des fichiers de configuration pour le .NET Framework