Номера версий основных и вспомогательных локализованных сборок
Класс SatelliteContractVersionAttribute обеспечивает поддержку управления версиями основных сборок, использующих локализованные ресурсы, с помощью диспетчера ресурсов. Использование атрибута SatelliteContractVersionAttribute в основной сборке приложения позволяет обновлять и повторно развертывать сборку, не обновляя при этом вспомогательные сборки. Например, класс SatelliteContractVersionAttribute можно использовать в составе пакета обновления, который не включает новых ресурсов, не выполняя повторного построения и развертывания вспомогательных сборок. Для обеспечения доступности локализованных ресурсов версия сопутствующего контракта основной сборки должна соответствовать классу AssemblyVersionAttribute вспомогательных сборок. В атрибуте SatelliteContractVersionAttribute необходимо указать точный номер версии; подстановочные знаки, такие как "*", не допускаются. Дополнительные сведения см. в разделе Извлечение ресурсов из вспомогательных сборок.
Обновление сборок
Класс SatelliteContractVersionAttribute позволяет обновлять основную сборку, не обновляя вспомогательную сборку, и наоборот. При обновлении основной сборки изменяется номер ее версии. Если нужно по-прежнему работать с существующими вспомогательными сборками, измените номер версии основной сборки, но оставьте номер версии вспомогательного контракта прежним. Например, первый выпуск основной сборки может иметь номер версии 1.0.0.0. Вспомогательный контракт и вспомогательная сборка также будут иметь номер версии 1.0.0.0. При необходимости обновления основной сборки для пакета обновления можно изменить версию сборки на 1.0.0.1 и при этом сохранить версию 1.0.0.0 вспомогательного контракта и вспомогательной сборки.
Если требуется обновить вспомогательную, а не основную сборку, следует изменить атрибут AssemblyVersionAttribute вспомогательной сборки. Вместе со вспомогательной сборкой потребуется отправить сборку политики, в которой будет говориться, что новая вспомогательная сборка совместима с предыдущей вспомогательной сборкой. Дополнительные сведения о политиках см. в разделе Обнаружение сборок средой выполнения.
Следующий фрагмент кода иллюстрирует задание версии вспомогательного контракта. Этот код можно поместить либо в скрипт построения, либо в файл AssemblyInfo.vb или AssemblyInfo.cs.
<Assembly: SatelliteContractVersionAttribute("4.3.2.1")>
[assembly: SatelliteContractVersionAttribute("4.3.2.1")]
См. также
Основные понятия
Обнаружение сборок в среде выполнения
Безопасность и локализованные вспомогательные сборки