Remove unused parameter (IDE0060)

Artikel
25/07/2023

Property	Value
Rule ID	IDE0060
Title	Remove unused parameter
Category	Style
Subcategory	Unnecessary code rules (parameter preferences)
Applicable languages	C# and Visual Basic
Options	`dotnet_code_quality_unused_parameters`

Overview

This rule flags unused parameters.

This rule does not flag parameters that are named with the discard symbol _. In addition, the rule ignores parameters that are named with the discard symbol followed by an integer, for example, _1. This behavior reduces warning noise on parameters that are needed for signature requirements, for example, a method used as a delegate, a parameter with special attributes, or a parameter whose value is implicitly accessed at run time by a framework but is not referenced in code.

Options

The option value specifies if unused parameters should be flagged only for non-public methods or for both public and non-public methods.

For information about configuring options, see Option format.

dotnet_code_quality_unused_parameters

Property	Value	Description
Option name	dotnet_code_quality_unused_parameters
Option values	`all`	Flag methods with any accessibility that contain unused parameters
	`non_public`	Flag only non-public methods that contain unused parameters
Default option value	`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

Suppress a warning

If you want to suppress only a single violation, add preprocessor directives to your source file to disable and then re-enable the rule.

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

To disable the rule for a file, folder, or project, set its severity to none in the configuration file.

ini

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

To disable all of the code-style rules, set the severity for the category Style to none in the configuration file.

ini

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

For more information, see How to suppress code analysis warnings.

Kongsi melalui