CA1016:用 AssemblyVersionAttribute 标记程序集
属性 | 值 |
---|---|
规则 ID | CA1016 |
标题 | 用 AssemblyVersionAttribute 标记程序集 |
类别 | 设计 |
修复是中断修复还是非中断修复 | 非中断 |
在 .NET 9 中默认启用 | 作为建议 |
原因
程序集没有版本号。
规则说明
程序集的标识由以下信息组成:
程序集名称
版本号
环境
公钥(用于强名称程序集)。
.NET 使用版本号来唯一标识程序集,并绑定到强名称程序集中的类型。 版本号与版本和发行者策略一起使用。 默认情况下,仅使用用于生成应用程序的程序集版本运行应用程序。
如何解决冲突
若要解决此规则的冲突,请使用 System.Reflection.AssemblyVersionAttribute 属性将版本号添加到程序集。
何时禁止显示警告
对于第三方或生产环境中使用的程序集,请勿禁止显示此规则的警告。
抑制警告
如果只想抑制单个冲突,请将预处理器指令添加到源文件以禁用该规则,然后重新启用该规则。
#pragma warning disable CA1016
// The code that's violating the rule is on this line.
#pragma warning restore CA1016
若要对文件、文件夹或项目禁用该规则,请在配置文件中将其严重性设置为 none
。
[*.{cs,vb}]
dotnet_diagnostic.CA1016.severity = none
有关详细信息,请参阅如何禁止显示代码分析警告。
示例
下面的示例演示应用了 AssemblyVersionAttribute 属性的程序集。
using System;
using System.Reflection;
[assembly: AssemblyVersionAttribute("4.3.2.1")]
namespace DesignLibrary {}
<Assembly: AssemblyVersionAttribute("4.3.2.1")>
Namespace DesignLibrary
End Namespace