SatelliteContractVersionAttribute Класс

Определение

Пространство имен:

System.Resources

Сборки:

netstandard.dll, System.Runtime.dll

Исходный код:

SatelliteContractVersionAttribute.cs

Указывает объекту ResourceManager запрашивать определенную версию вспомогательной сборки.

public ref class SatelliteContractVersionAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=false)]
public sealed class SatelliteContractVersionAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=false)>]
type SatelliteContractVersionAttribute = class
    inherit Attribute

Public NotInheritable Class SatelliteContractVersionAttribute
Inherits Attribute

Наследование

Object

Attribute

SatelliteContractVersionAttribute

Атрибуты

AttributeUsageAttribute

Комментарии

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

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

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

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

Конструкторы

Имя	Описание
SatelliteContractVersionAttribute(String)	Инициализирует новый экземпляр класса SatelliteContractVersionAttribute.

Свойства

Имя	Описание
TypeId	При реализации в производном классе получает уникальный идентификатор для этого Attribute. (Унаследовано от Attribute)
Version	Возвращает версию вспомогательных сборок с необходимыми ресурсами.

Методы

Имя	Описание
Equals(Object)	Возвращает значение, указывающее, равен ли этот экземпляр указанному объекту. (Унаследовано от Attribute)
GetHashCode()	Возвращает хэш-код для этого экземпляра. (Унаследовано от Attribute)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
IsDefaultAttribute()	При переопределении в производном классе указывает, является ли значение этого экземпляра значением по умолчанию для производного класса. (Унаследовано от Attribute)
Match(Object)	При переопределении в производном классе возвращает значение, указывающее, равен ли этот экземпляр указанному объекту. (Унаследовано от Attribute)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)