如何在全局抑制文件中抑制SYSLIB0051警告？

获取抑制所需的参数信息 #

SYSLIB0051是.NET 8中标记过时API的警告，你可以通过以下方式获取SuppressMessageAttribute所需的参数：

• 打开Visual Studio的输出窗口（切换到Build选项卡），找到SYSLIB0051的完整警告条目，里面会明确标注：
  • Category：固定为Usage（这类警告属于"API使用"范畴，不是Compiler）
  • CheckId：就是SYSLIB0051
  • 若警告指向特定过时API，MessageId会是该API的全名，但全局抑制时可省略，直接抑制所有该ID的警告
• 也可以在项目的错误列表中，右键点击SYSLIB0051警告，选择"抑制警告"→"在全局抑制文件中"，VS会自动生成正确的抑制代码，直接复用即可。

全局抑制文件的写法 #

1. 在项目中添加GlobalSuppressions.cs文件（若已存在则直接编辑）
2. 添加如下代码：

[assembly: System.Diagnostics.CodeAnalysis.SuppressMessage(
    "Usage", 
    "SYSLIB0051:已过时的API", 
    Scope = "Module", 
    Justification = "无法修改生成的代码"
)]

参数说明 #

• Category：必须填Usage，这是SYSLIB系列过时警告的固定类别
• CheckId：格式为SYSLIB0051:警告描述，也可以只写SYSLIB0051
• Scope：设为Module表示抑制整个项目（模块）内的所有SYSLIB0051警告，适合无法修改生成代码的场景
• Justification：必填项，需明确说明抑制理由，比如"无法修改生成的代码"

如果需要更精准的抑制（比如只针对某个生成的类型），可以将Scope改为Type，并在Target参数中指定类型的全名，但生成代码的类型名称可能不稳定，全局模块抑制是更稳妥的选择。

内容的提问来源于stack exchange，提问作者Martin