Elemento <linkedConfiguration>

Artículo
11/08/2023

Especifica un archivo de configuración para incluirlo.

<configuration>
<assemblyBinding>
<linkedConfiguration>

Sintaxis

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

Atributo

Atributo	Descripción
href	Atributo necesario. Dirección URL del archivo de configuración que se va a incluir. El único formato admitido para el atributo href es `file://`. Se admiten archivos locales y archivos UNC.

Elemento primario

Elemento	Descripción
<Elemento assemblyBinding>	Especifica la directiva de enlace del ensamblado en el nivel de configuración.

Elementos secundarios

None

Observaciones

El elemento <linkedConfiguration> simplifica el mantenimiento de los ensamblados de componentes. Si una o varias aplicaciones usan un ensamblado que tiene un archivo de configuración que reside en una ubicación conocida, sus archivos de configuración pueden usar el elemento <linkedConfiguration> para incluir el archivo de configuración del ensamblado, en lugar de duplicar la información de configuración. Cuando se realiza el mantenimiento del ensamblado de componentes, la actualización del archivo de configuración común proporciona información de configuración actualizada a todas las aplicaciones que usan el ensamblado.

Nota:

El elemento <linkedConfiguration> no se admite para las aplicaciones con manifiestos en paralelo de Windows.

Las reglas siguientes rigen el uso de archivos de configuración vinculados:

La configuración de los archivos de configuración incluidos solo afecta a la directiva de enlace del cargador y solo la usa este. Los archivos de configuración incluidos pueden tener valores distintos de las directivas de enlace, pero esos valores no tienen ningún efecto.
El único formato admitido para el atributo href es file://. Se admiten archivos locales y archivos UNC.
No hay ninguna restricción en el número de configuraciones vinculadas por archivo de configuración.
Todos los archivos de configuración vinculados se combinan para formar un archivo de configuración de ensamblado, similar al comportamiento de la directiva #include en C/C++.
El elemento <linkedConfiguration> solo se permite en los archivos de configuración de la aplicación. Si el elemento aparece en un archivo Machine.config, se omite.
No hay ninguna restricción en el contenido de los archivos de configuración incluidos, siempre que se ajusten al esquema del elemento primario <assemblyBinding>.
Las referencias circulares se detectan y se finalizan. Es decir, si los elementos <linkedConfiguration> de una serie de archivos de configuración forman un bucle, este se detecta y se detiene.

Ejemplo

En el ejemplo siguiente se muestra cómo incluir el archivo de configuración desde un disco duro local:

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