<linkedConfiguration>-Element

Artikel
11/04/2023

Gibt eine einzuschließende Konfigurationsdatei an.

<configuration>
<assemblyBinding>
<linkedConfiguration>

Syntax

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

attribute

attribute	BESCHREIBUNG
href	Erforderliches Attribut. Die URL der einzuschließenden 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	Beschreibung
<assemblyBinding>-Element	Gibt die Assemblybindungsrichtlinie auf Konfigurationsebene an.

Untergeordnete Elemente

Keine

Bemerkungen

Das <linkedConfiguration>-Element vereinfacht die Bereitstellung für Komponentenassemblys. Wenn mindestens eine Anwendung eine Assembly mit einer Konfigurationsdatei an einem bekannten Speicherort verwendet, können die Konfigurationsdateien das <linkedConfiguration>-Element verwenden, um die Assemblykonfigurationsdatei einzuschließen, anstatt Konfigurationsinformationen zu duplizieren. Wenn die Komponentenassembly bereitgestellt wird, werden durch das Aktualisieren der allgemeinen Konfigurationsdatei aktualisierte Konfigurationsinformationen für alle Anwendungen bereitgestellt, die die Assembly verwenden.

Hinweis

Das <linkedConfiguration>-Element wird für Anwendungen mit parallelen Windows-Manifesten nicht unterstützt.

Die folgenden Regeln bestimmen die Verwendung verknüpfter Konfigurationsdateien:

Die Einstellungen in eingeschlossenen Konfigurationsdateien wirken sich nur auf die Ladeprogrammbindungs-Richtlinie aus und werden nur vom Ladeprogramm verwendet. Die eingeschlossenen Konfigurationsdateien können andere Einstellungen als Bindungsrichtlinien haben, aber diese Einstellungen haben keine Auswirkungen.
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 hinsichtlich der Anzahl der verknüpften Konfigurationen pro Konfigurationsdatei.
Alle verknüpften Konfigurationsdateien werden zu einer Assemblykonfigurationsdatei zusammengeführt, ähnlich dem Verhalten der #include-Anweisung 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. Das heißt, wenn die <linkedConfiguration>-Elemente einer Reihe von Konfigurationsdateien eine Schleife bilden, wird die Schleife erkannt und beendet.

Beispiel

Das folgende Beispiel zeigt, wie die 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>

Freigeben über