<linkedConfiguration> komponent

Anger en konfigurationsfil som ska inkluderas.

<konfiguration>
   <assemblyBinding>
     <linkedConfiguration>

Syntax

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

Attribute

Attribute Description
href Obligatoriskt attribut.

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

Överordnat element

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

Underordnade element

None

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 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.

Anmärkning

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

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 det överordnade <assemblyBinding> elementet.

  • Cirkelreferenser identifieras och avslutas. Om elementen i <linkedConfiguration> en serie konfigurationsfiler bildar en loop identifieras loopen och stoppas.

Example

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>

Se även