SatelliteContractVersionAttribute 类

定义

指示 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)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class SatelliteContractVersionAttribute : Attribute
[<System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=false)>]
type SatelliteContractVersionAttribute = class
    inherit Attribute
[<System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=false)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type SatelliteContractVersionAttribute = class
    inherit Attribute
Public NotInheritable Class SatelliteContractVersionAttribute
Inherits Attribute
继承
SatelliteContractVersionAttribute
属性

注解

桌面应用

在桌面应用中,该 SatelliteContractVersionAttribute 属性在主程序集与其所有卫星之间建立协定。 将此属性应用于主程序集,并向其传递将使用此主程序集版本的附属程序集的版本号。 当资源管理器 (ResourceManager 对象) 查找资源时,它会在主程序集上显式加载此属性指定的附属版本。

更新主程序集时,会递增其程序集版本号。 但是,如果现有程序集与应用兼容,你可能不希望交付附属程序集的新副本。 在这种情况下,请递增主程序集的版本号,但使附属协定版本号保持不变。 资源管理器将使用现有的附属程序集。

如果要修改附属程序集而不是主程序集,请递增附属程序集上的版本号。 在这种情况下,将发布者策略程序集连同附属程序集一起交付,指出新的附属程序集与旧附属程序集向后兼容。 资源管理器仍将使用基于 SatelliteContractVersionAttribute 属性写入主程序集中的旧协定号;但是,加载程序将绑定到策略程序集指定的附属程序集版本。

共享组件的供应商使用发布者策略程序集对已发布程序集的特定版本发出兼容性声明。 发布者策略程序集是一个具有格式 policy.<major>.<minor>.<ComponentAssemblyName>名称的强名称程序集,在 全局程序集缓存中注册 (GAC) 。 发布者策略是从 XML 配置文件生成的, (使用 Al.exe (程序集链接器) 工具查看<bindingRedirect>元素) 。 程序集链接器与将 XML 配置文件链接到清单程序集的选项一起使用 /link ,该程序集随后存储在全局程序集缓存中。 当供应商提供包含 bug 修复的维护版本 (Service Pack) 时,可以使用发布者策略程序集。

Windows 8.x 应用商店应用

Windows 8.x 应用商店应用中忽略此属性,因为包资源索引 (PRI) 文件没有版本控制语义。 此外,Windows 8.x 应用商店打包模型要求所有资源在同一包中交付,并且不可能重新部署附属程序集或 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)

显式接口实现

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

将一组名称映射为对应的一组调度标识符。

(继承自 Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

检索对象的类型信息,然后可以使用该信息获取接口的类型信息。

(继承自 Attribute)
_Attribute.GetTypeInfoCount(UInt32)

检索对象提供的类型信息接口的数量(0 或 1)。

(继承自 Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

提供对某一对象公开的属性和方法的访问。

(继承自 Attribute)

适用于