Поделиться через


Элемент <linkedConfiguration>

Указание файла конфигурации, который следует включить.

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

Атрибуты и элементы

В следующих разделах описаны атрибуты, дочерние и родительские элементы.

Атрибуты

Атрибут

Описание

href

URL-адрес файла конфигурации, который необходимо включить. Для атрибута href поддерживается только один формат — "file://". Поддерживаются локальные файлы и файлы UNC.

Дочерние элементы

Отсутствует.

Родительские элементы

Элемент

Описание

Элемент <assemblyBinding> для <configuration>

Определяет политику привязки сборок на уровне конфигурации.

Заметки

Элемент <linkedConfiguration> упрощает обслуживание для сборок компонентов. Если одно или несколько приложений используют сборку, файл конфигурации которой находится в общеизвестном местоположении, файлы конфигурации приложений, использующих сборку, могут включать файл конфигурации сборки с помощью элемента <linkedConfiguration> и не использовать непосредственное включение информации о конфигурации. При обслуживании сборки компонентов обновление общего файла конфигурации позволяет обновить информацию о конфигурации для всех приложений, использующих эту сборку.

ПримечаниеПримечание

Элемент <linkedConfiguration> не поддерживается приложениями с параллельными манифестами Windows.

Для связанных файлов конфигурации действуют следующие правила.

  • Настройки включенного файла конфигурации затрагивают только политику привязки загрузчика и используются только загрузчиком. Включенные файлы конфигурации могут содержать настройки, не имеющие отношения к политикам привязки, но эти настройки не используются.

  • Для атрибута href поддерживается только один формат — "file://". Поддерживаются локальные файлы и файлы UNC.

  • Ограничение числа связанных конфигураций для файла конфигурации отсутствует.

  • Все связанные файлы конфигурации объединяются в один файл; схожим образом работает директива #include в C/C++.

  • Элемент <linkedConfiguration> разрешен только в файлах конфигурации приложений; в файле Machine.config этот элемент игнорируется.

  • Обнаружены и удалены циклические ссылки. Если элементы <linkedConfiguration> ряда файлов конфигурации образуют цикл, этот цикл обнаруживается и обрывается.

Пример

В следующем примере кода показано, как можно включить файл конфигурации с локального жесткого диска.

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

См. также

Ссылки

Элемент <assemblyBinding> для <configuration>

Другие ресурсы

Схема файлов конфигурации для .NET Framework