CA1014:用 CLSCompliantAttribute 标记程序集

属性	值
规则 ID	CA1014
标题	用 CLSCompliantAttribute 标记程序集
类别	设计
修复是中断修复还是非中断修复	非中断
在 .NET 8 中默认启用	否

原因

程序集没有已应用的 System.CLSCompliantAttribute 属性。

公共语言规范 (CLS) 定义了程序集在跨编程语言使用时必须符合的命名限制、数据类型和规则。好的设计要求所有程序集用 CLSCompliantAttribute 显式指示 CLS 合规性。如果程序集没有此属性，则该程序集即不合规。

符合 CLS 的程序集可能包含不合规的类型或类型成员。

若要解决此规则的冲突，请将属性添加到程序集。应确定不合规的类型或类型成员，并将这些元素标记为不合规，而不是将整个程序集标记为不相容。如果可能，应为不合规的成员提供符合 CLS 的替代方法，让尽可能多的用户能够访问程序集的所有功能。

不禁止显示此规则发出的警告。如果不希望程序集符合 CLS，请应用属性并将其值设置为 false。

如果只想抑制单个冲突，请将预处理器指令添加到源文件以禁用该规则，然后重新启用该规则。

#pragma warning disable CA1014
// The code that's violating the rule is on this line.
#pragma warning restore CA1014

若要对文件、文件夹或项目禁用该规则，请在配置文件中将其严重性设置为 none。

[*.{cs,vb}]
dotnet_diagnostic.CA1014.severity = none

下面的示例演示应用了 System.CLSCompliantAttribute 属性的程序集，该属性声明此程序集符合 CLS。

[assembly:CLSCompliant(true)]
namespace DesignLibrary {}

<assembly:CLSCompliant(true)>
Namespace DesignLibrary
End Namespace