<élément linkedConfiguration ><linkedConfiguration> element

Spécifie un fichier de configuration à inclure.Specifies a configuration file to include.

<configuration> <configuration>
   <assemblyBinding >   <assemblyBinding>
     <linkedConfiguration >    <linkedConfiguration>

SyntaxeSyntax

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

AttributAttribute

DescriptionDescription
hrefhref Attribut requis.Required attribute.

URL du fichier de configuration à inclure.The URL of the configuration file to include. Le seul format pris en charge pour l’attribut href est file://.The only format supported for the href attribute is file://. Les fichiers locaux et les fichiers UNC sont pris en charge.Local files and UNC files are supported.

Élément parentParent element

DescriptionDescription
<assemblyBinding > Appartient<assemblyBinding> Element Spécifie la stratégie de liaison de l’assembly au niveau de la configuration.Specifies assembly binding policy at the configuration level.

Éléments enfantsChild elements

aucune.None

NotesRemarks

L’élément <linkedConfiguration > simplifie la maintenance des assemblys de composants.The <linkedConfiguration> element simplifies servicing for component assemblies. Si une ou plusieurs applications utilisent un assembly qui a un fichier de configuration résidant 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 de l’assembly, plutôt que d’inclure directement les informations de configuration.If one or more applications use an assembly that has a configuration file residing in a well-known location, the configuration files of the applications that use the assembly can use the <linkedConfiguration> element to include the assembly configuration file, rather than including configuration information directly. Lorsque l’assembly de composant est desservi, la mise à jour du fichier de configuration commun fournit des informations de configuration mises à jour à toutes les applications qui utilisent l’assembly.When the component assembly is serviced, updating the common configuration file provides updated configuration information to all applications that use the assembly.

Notes

L’élément <linkedConfiguration > n’est pas pris en charge pour les applications avec des manifestes côte à côte Windows.The <linkedConfiguration> element is not supported for applications with Windows side-by-side manifests.

Les règles suivantes régissent l’utilisation des fichiers de configuration liés :The following rules govern the use of linked configuration files:

  • Les paramètres dans les fichiers de configuration inclus affectent uniquement la stratégie de liaison du chargeur et sont utilisés uniquement par le chargeur.The settings in included configuration files only affect loader binding policy and are used only by the loader. 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.The included configuration files can have settings other than binding policies, but those settings don't have any effect.

  • Le seul format pris en charge pour l’attribut href est file://.The only format supported for the href attribute is file://. Les fichiers locaux et les fichiers UNC sont pris en charge.Local files and UNC files are supported.

  • Il n’existe aucune contrainte sur le nombre de configurations liées par fichier de configuration.There is no constraint on the number of linked configurations per configuration file.

  • Tous les fichiers de configuration liés sont fusionnés pour former un fichier, de la même façon que le comportement de laC++directive #include en C/.All linked configuration files are merged to form one file, similar to the behavior of the #include directive in C/C++.

  • L’élément <linkedConfiguration > est autorisé uniquement dans les fichiers de configuration de l’application ; elle est ignorée dans le fichier machine. config.The <linkedConfiguration> element is allowed only in application configuration files; it's ignored in Machine.config.

  • Les références circulaires sont détectées et arrêtées.Circular references are detected and terminated. Autrement dit, si le <linkedConfiguration > éléments d’une série de fichiers de configuration forment une boucle, la boucle est détectée et arrêtée.That is, if the <linkedConfiguration> elements of a series of configuration files form a loop, the loop is detected and stopped.

ExempleExample

L’exemple suivant montre comment inclure le fichier de configuration à partir du disque dur local :The following example shows how to include configuration file from the local hard disk:

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

Voir aussiSee also