删除未使用的参数(IDE0060)

财产 价值
规则 ID IDE0060
标题 删除未使用的参数
类别 样式
子类别 不必要的代码规则(参数首选项)
适用的语言 C# 和 Visual Basic
选项 dotnet_code_quality_unused_parameters

概述

此规则标记未使用的参数。

此规则不会标记以丢弃符号 _ 命名的参数。 此外,该规则会忽略以丢弃符号命名的参数,其后是一个整数,例如,_1。 此行为可减少签名要求所需的参数的警告干扰,例如,用作委托的方法、具有特殊属性的参数,或框架在运行时隐式访问其值但未在代码中引用的参数。

选项

选项值指定是否应仅针对非公共方法或公共和非公共方法标记未使用的参数。

有关配置选项的信息,请参阅 选项格式

dotnet_code_quality_unused_parameters

财产 价值 描述
选项名称 dotnet_code_quality_unused_parameters
选项值 all 标记具有包含未使用的参数的任何可访问性的方法
non_public 仅标记包含未使用参数的非公共方法
默认选项值 all
// dotnet_code_quality_unused_parameters = all
public int GetNum1(int unusedParam) { return 1; }
internal int GetNum2(int unusedParam) { return 1; }
private int GetNum3(int unusedParam) { return 1; }

// dotnet_code_quality_unused_parameters = non_public
internal int GetNum4(int unusedParam) { return 1; }
private int GetNum5(int unusedParam) { return 1; }
' dotnet_code_quality_unused_parameters = all
Public Function GetNum1(unused As Integer)
    Return 1
End Function

Friend Function GetNum2(unused As Integer)
    Return 1
End Function

Private Function GetNum3(unused As Integer)
    Return 1
End Function

' dotnet_code_quality_unused_parameters = non_public
Friend Function GetNum4(arg1 As Integer)
    Return 1
End Function

Private Function GetNum5(arg1 As Integer)
    Return 1
End Function

禁止显示警告

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

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

若要禁用文件、文件夹或项目的规则,请将其严重性设置为 配置文件中的 none

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

若要禁用所有代码样式规则,请将类别 Style 的严重性设置为 配置文件中的 none

[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Style.severity = none

有关详细信息,请参阅 如何取消代码分析警告

另请参阅