<linkedConfiguration>-Element
Aktualisiert: November 2007
Gibt eine einzuschließende Konfigurationsdatei an.
<configuration>-Element
<assemblyBinding>-Element für <configuration>
<linkedConfiguration>-Element
<linkedConfiguration
href="URL of linked configuration file"/>
Attribute und Elemente
In den folgenden Abschnitten werden Attribute und untergeordnete sowie übergeordnete Elemente beschrieben.
Attribute
Attribut |
Beschreibung |
|---|---|
href |
Der URL der Konfigurationsdatei, die eingeschlossen werden soll. Das einzige unterstützte Format für das href-Attribut ist "file://". Lokale Dateien und UNC-Dateien werden unterstützt. |
Untergeordnete Elemente
Keines.
Übergeordnete Elemente
Element |
Beschreibung |
|---|---|
Gibt die Assemblybindungsrichtlinie auf Konfigurationsebene an. |
Hinweise
Das <linkedConfiguration>-Element vereinfacht die Wartung für Komponentenassemblys. Wenn eine oder mehrere Anwendungen eine Assembly verwenden, deren Konfigurationsdatei sich an einem bekannten Speicherort befindet, können die Konfigurationsdateien der Anwendungen, die die Assembly verwenden, das <linkedConfiguration>-Element verwenden, um die Assemblykonfigurationsdatei einzuschließen, anstatt Konfigurationsinformationen direkt einzuschließen. Wenn die Komponentenassembly gewartet wird, erhalten alle Anwendungen, die die Assembly verwenden, mit einer Aktualisierung der gemeinsamen Konfigurationsdatei aktualisierte Konfigurationsinformationen.
Tipp
Das <linkedConfiguration>-Element wird nicht für Anwendungen mit parallelen Manifestdateien in Windows unterstützt.
Die Verwendung verknüpfter Konfigurationsdateien unterliegt den folgenden Regeln.
Die Einstellungen in eingeschlossenen Konfigurationsdateien wirken sich nur auf die Bindungsrichtlinie des Ladeprogramms aus und werden nur von ihm verwendet. Die eingeschlossenen Konfigurationsdateien können außer den Bindungsrichtlinien andere Einstellungen haben, aber diese Einstellungen haben keine Auswirkungen.
Das einzige unterstützte Format für das href-Attribut ist "file://". Lokale Dateien und UNC-Dateien werden unterstützt.
Es gibt keine Einschränkung für die Anzahl verknüpfter Konfigurationen pro Konfigurationsdatei.
Alle verknüpften Konfigurationsdateien werden in einer Datei zusammengeführt; dies ähnelt dem Verhalten der #include-Direktive in C/C++.
Das <linkedConfiguration>-Element wird nur in Anwendungskonfigurationsdateien zugelassen; in Machine.config wird es ignoriert.
Zirkelverweise werden erkannt und beendet. Das heißt, wenn die <linkedConfiguration>-Elemente einer Reihe von Konfigurationsdateien eine Schleife bilden, wird die Schleife erkannt und gestoppt.
Beispiel
Das folgende Codebeispiel zeigt, wie eine Konfigurationsdatei von der 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
Referenz
<assemblyBinding>-Element für <configuration>