Élément <linkedConfiguration>

Article
10/31/2023

Spécifie un fichier de configuration à inclure.

<configuration>
<assemblyBinding>
<linkedConfiguration>

Syntaxe

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

Attribut

Attribut	Description
href	Attribut requis. URL du fichier de configuration à inclure. Le seul format pris en charge pour l’attribut href est `file://`. Les fichiers locaux et les fichiers UNC sont pris en charge.

Élément parent

Élément	Description
<Élément assemblyBinding>	Spécifie la stratégie de liaison de l’assembly au niveau de la configuration.

Éléments enfants

None

Notes

L’élément <linkedConfiguration> simplifie la maintenance des assemblys de composants. Si une ou plusieurs applications utilisent un assembly qui possède un fichier de configuration situé à 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 que de dupliquer les informations de configuration. Lorsque l’assembly de composant est utilisé, 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 régissent l’utilisation des 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 avoir des paramètres autres que des 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 sur le nombre de configurations liées par fichier de configuration.
Tous les fichiers de configuration liés sont fusionnés pour former un fichier de configuration, à l’image du comportement de la directive #include en C/C++.
L’élément <linkedConfiguration> est autorisé uniquement dans les fichiers de configuration d’application. Si l’élément apparaît dans un fichier Machine.config, il est ignoré.
Il n’existe aucune restriction sur le contenu des fichiers de configuration inclus, tant qu’ils sont conformes au schéma de l’élément <assemblyBinding> parent.
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 suivant montre comment inclure un fichier de configuration à partir d’un disque dur local :

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

Partager via