<Элемент linkedConfiguration>

  • Статья

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

<configuration>
  <assemblyBinding>
    <linkedConfiguration>

Синтаксис

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

Атрибут

Атрибут Description
href Обязательный атрибут элемента .

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

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

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

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

нет

Замечания

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

Примечание.

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

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

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

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

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

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

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

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

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

Пример

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

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

См. также