Partager via

élément <linkedConfiguration>

Spécifie un fichier de configuration à inclure.

<configuration>
  <assemblyBinding>
    <linkedConfiguration>

Syntaxe

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

Caractéristique

Caractéristique Descriptif
href Attribut obligatoire.

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 Descriptif
<assemblyBinding> Spécifie la stratégie de liaison d’assembly au niveau de la configuration.

Éléments enfants

Aucun

Remarques

L’élément simplifie la <linkedConfiguration> maintenance des assemblys de composants. Si une ou plusieurs applications utilisent un assembly qui a un fichier de configuration résidant dans un emplacement connu, leurs fichiers de configuration 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 pour toutes les applications qui utilisent l’assembly.

Note

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 d’assembly, similaire au comportement de la #include directive 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 parent <assemblyBinding> .

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

Example

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>

Voir aussi

  • Last updated on