<linkedConfiguration-element>

Artikel
10/27/2023

Anger en konfigurationsfil som ska inkluderas.

<Konfiguration>
<assemblyBinding>
<linkedConfiguration>

Syntax

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

Attribut

Attribut	Description
Href	Obligatoriskt attribut. URL:en för konfigurationsfilen som ska inkluderas. Det enda format som stöds för href-attributet är `file://`. Lokala filer och UNC-filer stöds.

Överordnat element

Element	Description
<assemblyBinding-element>	Anger sammansättningsbindningsprincip på konfigurationsnivå.

Underordnade element

Inga

Anmärkningar

Elementet <linkedConfiguration> förenklar service för komponentsammansättningar. Om ett eller flera program använder en sammansättning som har en konfigurationsfil som finns på en välkänd plats kan deras konfigurationsfiler använda elementet <linkedConfiguration> för att inkludera konfigurationsfilen för sammansättning i stället för att duplicera konfigurationsinformation. När komponentsammansättningen betjänas ger uppdatering av den gemensamma konfigurationsfilen uppdaterad konfigurationsinformation till alla program som använder sammansättningen.

Kommentar

Elementet <linkedConfiguration> stöds inte för program med Manifest sida vid sida i Windows.

Följande regler styr användningen av länkade konfigurationsfiler:

Inställningarna i de inkluderade konfigurationsfilerna påverkar bara inläsningsbindningsprincipen och används endast av inläsaren. De inkluderade konfigurationsfilerna kan ha andra inställningar än bindningsprinciper, men de inställningarna har ingen effekt.
Det enda format som href stöds för attributet är file://. Lokala filer och UNC-filer stöds.
Det finns ingen begränsning för antalet länkade konfigurationer per konfigurationsfil.
Alla länkade konfigurationsfiler sammanfogas för att bilda en sammansättningskonfigurationsfil, ungefär som beteendet för #include direktivet i C/C++.
Elementet <linkedConfiguration> tillåts endast i programkonfigurationsfiler. Om elementet visas i en Machine.config-fil ignoreras det.
Det finns ingen begränsning för innehållet i de inkluderade konfigurationsfilerna, så länge de överensstämmer med schemat för den överordnade <sammansättningenBinding-elementet> .
Cirkelreferenser identifieras och avslutas. Om elementen <linkedConfiguration> i en serie konfigurationsfiler bildar en loop identifieras och stoppas loopen.

Exempel

I följande exempel visas hur du inkluderar konfigurationsfilen från en lokal hårddisk:

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

Dela via