элемент <linkedConfiguration>

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

<configuration>
  <assemblyBinding>
    <linkedConfiguration>

Синтаксис

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

Свойство

Свойство Description
href Обязательный атрибут.

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

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

Элемент Description
<assemblyBinding> Указывает политику привязки сборок на уровне конфигурации.

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

None

Замечания

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

Замечание

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

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

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

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

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

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

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

  • Нет ограничений на содержимое включенных файлов конфигурации, если они соответствуют схеме родительского <assemblyBinding> элемента.

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

Example

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

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

См. также

  • Last updated on