Файлы конфигурации приложений

Файл конфигурации приложения — это XML-файл, используемый для управления привязкой сборки. Он может перенаправлять приложение с одной версии параллельной сборки в другую версию той же сборки. Это называется конфигурацией для каждого приложения. Файл конфигурации приложения применяется только к определенному манифесту приложения и зависимым сборкам. Для изолированных компонентов, скомпилированных с помощью встроенного манифеста ISOLATIONAWARE_MANIFEST_RESOURCE_ID, требуется отдельный файл конфигурации приложения. Манифестам, управляемым с помощью CreateActCtx, требуется отдельный файл конфигурации приложения.

Перенаправление, указанное в файле конфигурации приложения, может переопределить версии сборки, указанные в манифестах приложения и файлах конфигурации издателя. Например, если файл конфигурации издателя указывает, что все ссылки на сборку будут перенаправлены с версии 1.0.0.0 на 1.1.0.0, файл конфигурации приложения можно использовать для перенаправления конкретного приложения на использование версии 1.0.0.0. Файл конфигурации приложения применяется только к указанному манифесту приложения и зависимым сборкам.

Полный список XML-схемы см. в разделе Схема файла конфигурации приложения.

Файлы конфигурации приложения содержат элементы и атрибуты, показанные в следующей таблице.

Элемент	Атрибуты	Обязательно
Конфигурация		Да
windows		Да
publisherPolicy		Да
	Применить	Да
Среда выполнения		Нет
assemblyBinding		Да
Зондирования		Нет
	privatePath	Да
Зависимостей		Нет
dependentAssembly		Да
assemblyIdentity		Да
	type	Да
	name	Да
	language	Нет
	processorArchitecture	Да
	version	Да
	Publickeytoken	Нет
bindingRedirect		Да
	oldVersion	Да
	newVersion	Да

Расположение файла

Файлы конфигурации приложения должны быть установлены в том же расположении, что и манифест приложения.

Синтаксис имени файла

Имя файла конфигурации приложения — это имя исполняемого файла приложения, за которым следует .config.

Например, файл конфигурации приложения, ссылающийся на Example.exe или Example.dll, будет использовать синтаксис имени файла, показанный в следующем примере. Вы можете опустить поле идентификатора <ресурса> , если устанавливается файл конфигурации как отдельный файл или если идентификатор ресурса равен 1.

example.exe.<идентификатор> ресурса.config

example.dll.<идентификатор> ресурса.config

Элементы

Имена элементов и атрибутов чувствительны к регистру. Значения элементов и атрибутов не учитывают регистр, за исключением значения атрибута типа.

настройка

Элемент контейнера для элементов windows и среды выполнения файла конфигурации приложения. Обязательный.

Windows

Включает части файла конфигурации приложения, которые применяются к перенаправлению сборок Win32.

Примечание

Автор приложения не должен включать файл конфигурации с подэлементом Windows в составе приложения. Это может быть разрешено, если единственной целью файла конфигурации является включение функций privatePath элемента пробы . Элемент probing недоступен в системах более ранних версий, чем Windows Server 2008 R2 и Windows 7.

publisherPolicy

Указывает, следует ли применять политику издателя.

Этот элемент содержит атрибуты, показанные в следующей таблице.

attribute	Описание
Применить	Значение "да" применяет политику издателя. Это параметр по умолчанию. Значение "нет" не применяет политику издателя.

среда выполнения

Включает части файла конфигурации приложения, которые применяются к перенаправлению сборок .NET.

assemblyBinding

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

Начиная с Windows Server 2008 R2 и Windows 7 элемент assemblyBinding может включать в себя подэлемент проверки .

Зондирования

Необязательный вложенный элемент элемента assemblyBinding , который расширяет поиск сборок на дополнительные каталоги. Дополнительные каталоги не обязательно должны быть подкаталогами каталога сборки.

Примечание

Этот элемент недоступен в системах, предшествующих Windows Server 2008 R2 и Windows 7, и может использоваться только в элементе Windows .

Этот элемент содержит атрибуты, показанные в следующей таблице.

attribute	Описание
privatePath	Указывает относительные пути к подкаталогам базового каталога приложения, который может содержать сборки. Можно указать не более девяти путей к подкаталогу. Разделите путь к каждому подкаталогу точкой с запятой.

Можно использовать специальный описатель с двойными точками в пути, чтобы обозначить родительский каталог текущего каталога. С помощью двойных точек можно указать не более двух уровней над текущим каталогом. Не используйте тройные точки. Например, приложение, использующее следующий проверочный элемент, проверяет наличие дополнительных каталогов для сборки.

<probing privatePath="bin;..\bin2\subbin;bin3"/>

dependency

Элемент контейнера по крайней мере для одного dependentAssembly. Каждый dependAssembly может находиться в пределах ровно одной зависимости. Этот элемент не содержит атрибуты. Необязательный элемент.

dependentAssembly

Первый вложенный элемент должен быть элементом assemblyIdentity , который определяет параллельную сборку, перенаправленную файлом конфигурации приложения. У объекта dependentAssembly нет атрибутов.

assemblyIdentity

В качестве первого подэлемента элемента assemblyBindingassemblyIdentity описывает и однозначно идентифицирует приложение. Файл конфигурации приложения перенаправляет привязку этого приложения в параллельные сборки. Например, следующая assemblyIdentity указывает, что файл конфигурации приложения влияет на привязку приложения mysampleApp к параллельным сборкам. Перенаправляемые сборки будут определены в dependentAssembly.

<assemblyIdentity processorArchitecture="X86" name="Microsoft.Windows.mysampleApp" type="win32" version="1.0.0.0"/>

В качестве первого подэлемента элемента dependentAssemblyassemblyIdentity описывает параллельную сборку, от которой зависит приложение. Файл конфигурации приложения перенастраивает удостоверение этой необходимой сборки. Например, следующие assemblyIdentity и bindingRedirect перенастраивает зависимость от Microsoft.Windows.SampleAssembly с версии 2.0.0.0 на версию 2.1.0.0.

<dependency>
      <dependentAssembly>
         <assemblyIdentity type="win32"
          name="Microsoft.Windows.SampleAssembly"
          processorArchitecture="x86"
          publicKeyToken="0000000000000000"/>
         <bindingRedirect oldVersion="2.0.0.0" newVersion="2.1.0.0"/>
      </dependentAssembly>
</dependency>

Обратите внимание, что каждая assemblyIdentity , включенная в dependentAssembly , должна точно соответствовать assemblyIdentity в манифесте сборки.

Элемент assemblyIdentity имеет следующие атрибуты. У него нет подэлементов.

attribute	Описание
type	Значение должно быть win32 (в нижнем регистре). Обязательный.
name	Атрибут name определяет приложение, на которое влияет файл конфигурации приложения или перенаправляемая сборка. Используйте следующий формат для имени: Organization.Division.Name. Обязательный. Например: Microsoft.Windows.MysampleApp или Microsoft.Windows.MysampleAsm.
language	Определяет язык. Необязательный элемент. Для assemblyIdentity , ссылающегося на сборку, если сборка зависит от языка, укажите код языка DHTML. Если сборка используется по всему миру (нейтралитет языка), задайте значение "*".
processorArchitecture	Указывает процессор, на котором выполняется приложение.
version	Указывает версию приложения или сборки. Используйте синтаксис версии из четырех частей: mmmm.nnnn.чикo.pppp. Обязательный.
Publickeytoken	Для assemblyIdentity , ссылающегося на сборку, это шестнадцатеричная строка из 16 символов, представляющая последние 8 байт хэша SHA-1 открытого ключа, под которым подписывается сборка. Открытый ключ, используемый для подписи каталога, должен иметь значение 2048 бит или больше. Требуется для всех общих параллельных сборок.

bindingRedirect

Элемент bindingRedirect содержит сведения о перенаправлении для привязки сборки. Каждый bindingRedirect должен быть включен только в один dependentAssembly. Синтаксис новой и старой версий из четырех частей должен указывать одну и ту же основную и дополнительную версии.

Этот элемент содержит атрибуты, показанные в следующей таблице.

attribute	Описание
oldVersion	Указывает версию сборки, для которой выполняется переопределение и перенаправление. Используйте синтаксис версии из четырех частей nnnnn.nnnnn.nnnnn.nnnnn. Укажите диапазон версий с помощью дефиса без пробелов. Например, 2.14.3.0 или 2.14.3.0 2.16.0.0. Обязательный.
newVersion	Указывает версию заменяемой сборки. Используйте синтаксис версии из четырех частей nnnnn.nnnnn.nnnnn.nnnnn.

Комментарии

Файлы конфигурации приложения не указываются.

Пример

<bindingRedirect oldVersion="1.0.0.0" newVersion="1.0.10.0"/>
<bindingRedirect oldVersion="1.0.50.2011-1.0.60.65535" newVersion="1.0.70.0"/>