Класс System.Resources.SatelliteContractVersionAttribute

В этой статье приводятся дополнительные замечания к справочной документации по этому API.

В классических приложениях SatelliteContractVersionAttribute атрибут устанавливает контракт между основной сборкой и всеми его спутниками. Этот атрибут применяется к основной сборке и передается номер версии вспомогательных сборок, которые будут работать с этой версией основной сборки. Когда диспетчер ресурсов (ResourceManager объект) ищет ресурсы, она явно загружает спутниковую версию, указанную этим атрибутом, в основной сборке.

При обновлении основной сборки увеличивается номер версии сборки. Однако, возможно, вам не нужно отправлять новые копии вспомогательных сборок, если существующие совместимы с вашим приложением. В этом случае увеличьте номер версии основной сборки, но оставьте номер версии вспомогательного контракта одинаковым. Диспетчер ресурсов будет использовать существующие вспомогательные сборки.

Если вы хотите пересмотреть вспомогательные сборки, но не основную сборку, увеличьте номер версии на спутнике. В этом случае отправьте сборку политики издателя вместе со вспомогательной сборкой, заявив, что новая спутниковая сборка имеет обратную совместимость со старой вспомогательной сборкой. Диспетчер ресурсов по-прежнему будет использовать старый номер контракта, записанный в основную сборку на SatelliteContractVersionAttribute основе атрибута. Однако загрузчик привязывается к вспомогательной версии сборки, указанной сборкой политики.

Поставщик общего компонента использует сборку политики издателя, чтобы сделать оператор совместимости определенной версии выпущенной сборки. Сборка политики издателя — это строго именованная сборка, которая имеет имя в формате policy.<major>.<minor>.<ComponentAssemblyName>и зарегистрирована в глобальном кэше сборок (GAC). Политика издателя создается из XML-файла конфигурации (см<. элемент bindingRedirect>) с помощью средства Al.exe (компоновщик сборок). Компоновщик сборок используется с параметром для связывания XML-файла конфигурации с /link сборкой манифеста, которая затем хранится в глобальном кэше сборок. Сборки политики издателя можно использовать при отправке поставщиком выпуска обслуживания (пакета обновления), содержащего исправления ошибок.

Приложения Магазина Windows 8.x

Этот атрибут игнорируется в приложениях Магазина Windows 8.x, так как файлы индекса ресурсов пакета (PRI) не имеют семантики управления версиями. Кроме того, модель упаковки Магазина Windows 8.x требует отправки всех ресурсов в одном пакете без возможности повторного развертывания вспомогательных сборок или файлов PRI.