源代码中禁止显示是指通过使用 SuppressMessage属性禁止显示或忽略代码分析冲突的功能。SuppressMessage属性是一个条件属性,只有在编译时定义了 CODE_ANALYSIS 编译符号时,它才会包含在托管代码程序集的 IL 元数据中。在 C++ 中,可以通过两个宏 CA_SUPPRESS_MESSAGE 和 CA_GLOBAL_SUPPRESS_MESSAGE 实现相同的目的。
建议您在调试版本或签入版本中使用源代码中禁止显示,以避免错误地提供源代码中禁止显示元数据以及由于元数据膨胀而影响执行或性能。
SuppressMessage 的用法
在应用 SuppressMessage 属性的实例的级别上,禁止显示代码分析警告。执行此操作的目的是为了使禁止显示信息与发生冲突的代码紧密耦合。
禁止显示的一般形式包括规则类别和一个规则标识符,该标识符包含可选的规则名称的用户可读表示形式。例如,
[SuppressMessage("Microsoft.Design", "CA1039:ListsAreStrongTyped")]
如果出于严格的性能原因,要求最大程度地减少代码内禁止显示元数据,则可以省略规则名称本身。规则类别及其规则 ID 一起构成足够唯一的规则标识符。例如,
[SuppressMessage("Microsoft.Design", "CA1039")]
出于可维护性的原因,建议不要使用该格式。
SuppressMessage 属性
当您右击“错误列表”中的某个代码分析警告并单击“禁止显示消息”时,SuppressMessage 属性将添加到您的代码中,或者添加到项目的全局禁止显示文件中。
SuppressMessage 属性的格式如下所示:
C#
[Scope:SuppressMessage("Rule