<linkedConfiguration> – element

  • Článek

Určuje konfigurační soubor, který se má zahrnout.

<Konfigurace>
  <AssemblyBinding>
    <linkedConfiguration>

Syntaxe

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

Atribut

Atribut Popis
Href Požadovaný atribut.

Adresa URL konfiguračního souboru, který se má zahrnout. Jediný formát podporovaný atributem href je file://. Podporují se místní soubory a soubory UNC.

Nadřazený prvek

Element (Prvek) Popis
<assemblyBinding> – element Určuje zásadu vazby sestavení na úrovni konfigurace.

Podřízené prvky

Nic

Poznámky

Element <linkedConfiguration> zjednodušuje údržbu sestavení součástí. Pokud jedna nebo více aplikací používá sestavení s konfiguračním souborem umístěným v dobře známém umístění, mohou jejich konfigurační soubory použít <element linkedConfiguration> k zahrnutí konfiguračního souboru sestavení místo duplikování informací o konfiguraci. Při obsluhování sestavení součásti poskytuje aktualizace společného konfiguračního souboru aktualizované informace o konfiguraci pro všechny aplikace, které sestavení používají.

Poznámka:

Element <linkedConfiguration> není podporován pro aplikace s manifesty Windows vedle sebe.

Použití propojených konfiguračních souborů se řídí následujícími pravidly:

  • Nastavení v zahrnutých konfiguračních souborech mají vliv pouze na zásady vazby zavaděče a používají se pouze zavaděčem. Zahrnuté konfigurační soubory můžou mít jiná nastavení než zásady vazby, ale tato nastavení nemají žádný vliv.

  • Jediný formát podporovaný atributem href je file://. Podporují se místní soubory a soubory UNC.

  • Počet propojených konfigurací na konfigurační soubor není nijak omezený.

  • Všechny propojené konfigurační soubory jsou sloučeny tak, aby vytvořily jeden konfigurační soubor sestavení, podobně jako chování direktivy #include v C/C++.

  • Element <linkedConfiguration> je povolen pouze v konfiguračních souborech aplikace. Pokud se prvek zobrazí v souboru Machine.config , bude ignorován.

  • Neexistuje žádné omezení obsahu zahrnutých konfiguračních souborů, pokud odpovídají schématu nadřazeného <elementu assemblyBinding> .

  • Cyklické odkazy se detekují a ukončují. To znamená, že pokud <propojené prvky konfigurace> řady konfiguračních souborů tvoří smyčku, smyčka se zjistí a zastaví.

Příklad

Následující příklad ukazuje, jak zahrnout konfigurační soubor z místního pevného disku:

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

Viz také