选择诊断 ID

诊断 ID 是与给定诊断关联的字符串，例如编译器错误或分析器生成的诊断。

ID 来自各种 API，例如：

• DiagnosticDescriptor.Id
• ObsoleteAttribute.DiagnosticId
• ExperimentalAttribute.DiagnosticId

诊断 ID 还用作源中的标识符，例如，在 #pragma 警告禁用或 .editorconfig 文件中。

注意事项

• 诊断 ID 应是唯一的
• 诊断 ID 必须是 C# 中的合法标识符
• 诊断 ID 长度应小于 15 个字符
• 诊断 ID 应采用 <PREFIX><number> 形式
  • 前缀特定于项目
  • 该数字表示特定的诊断

注意

更改诊断 ID 是源中断性变更，因为如果 ID 发生更改，将会忽略现有抑制。

不要将前缀限制为两个字符（例如 CSXXX 和 CAXXXX）。 请改用较长的前缀来避免冲突。 例如，System.* 诊断使用 SYSLIB 作为其前缀。