Freigeben über

<linkedConfiguration>-Element

Gibt eine einzuschließde Konfigurationsdatei an.

<Konfiguration>
   <assemblyBinding>
     <linkedConfiguration>

Syntax

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

Merkmal

Merkmal Description
href Erforderliches Attribut.

Die URL der einzuschließden Konfigurationsdatei. Das einzige format, das für das href Attribut unterstützt wird, ist file://. Lokale Dateien und UNC-Dateien werden unterstützt.

Übergeordnetes Element

Element Description
<assemblyBinding> Element Gibt die Assemblybindungsrichtlinie auf Konfigurationsebene an.

Untergeordnete Elemente

Nichts

Bemerkungen

Das <linkedConfiguration> Element vereinfacht die Wartung für Komponentenassemblys. Wenn eine oder mehrere Anwendungen eine Assembly verwenden, die über eine Konfigurationsdatei verfügt, die sich an einem bekannten Speicherort befindet, können ihre Konfigurationsdateien das <linkedConfiguration> Element verwenden, um die Assemblykonfigurationsdatei einzuschließen, anstatt Konfigurationsinformationen zu duplizieren. Wenn die Komponentenassembly gewartet wird, stellt das Aktualisieren der allgemeinen Konfigurationsdatei aktualisierte Konfigurationsinformationen für alle Anwendungen bereit, die die Assembly verwenden.

Hinweis

Das <linkedConfiguration> Element wird für Anwendungen mit Parallelmanifesten von Windows nicht unterstützt.

Die folgenden Regeln regeln die Verwendung verknüpfter Konfigurationsdateien:

  • Die Einstellungen in den enthaltenen Konfigurationsdateien wirken sich nur auf die Richtlinie für die Ladeprogrammbindung aus und werden nur vom Ladeprogramm verwendet. Die enthaltenen Konfigurationsdateien können andere Einstellungen als Bindungsrichtlinien haben, diese Einstellungen haben jedoch keine Auswirkung.

  • Das einzige format, das für das href Attribut unterstützt wird, ist file://. Lokale Dateien und UNC-Dateien werden unterstützt.

  • Es gibt keine Einschränkung für die Anzahl der verknüpften Konfigurationen pro Konfigurationsdatei.

  • Alle verknüpften Konfigurationsdateien werden mit einer Assemblykonfigurationsdatei zusammengeführt, ähnlich dem Verhalten der #include Direktive in C/C++.

  • Das <linkedConfiguration> Element ist nur in Anwendungskonfigurationsdateien zulässig. Wenn das Element in einer Machine.config Datei angezeigt wird, wird es ignoriert.

  • Es gibt keine Einschränkung für den Inhalt der enthaltenen Konfigurationsdateien, solange sie dem Schema des übergeordneten <assemblyBinding> Elements entsprechen.

  • Zirkelbezüge werden erkannt und beendet. Wenn die <linkedConfiguration> Elemente einer Reihe von Konfigurationsdateien eine Schleife bilden, wird die Schleife erkannt und beendet.

Example

Das folgende Beispiel zeigt, wie Konfigurationsdatei von einer lokalen Festplatte eingeschlossen wird:

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

Siehe auch

  • Last updated on