Класс System.Resources.SatelliteContractVersionAttribute

Замечание

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

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

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

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

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

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

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