删除不必要的表达式值(IDE0058)
财产 | 价值 |
---|---|
规则 ID | IDE0058 |
标题 | 删除不必要的表达式值 |
类别 | 样式 |
子类别 | 语言规则(表达式级首选项) |
适用的语言 | C# 和 Visual Basic |
选项 | csharp_style_unused_value_expression_statement_preference |
visual_basic_style_unused_value_expression_statement_preference |
概述
此规则标记未使用的表达式值。 例如:
void M()
{
Compute(); // IDE0058: computed value is never used.
}
int Compute();
可以采取下列措施之一来纠正此违规:
如果表达式没有副作用,请删除整个语句。 这通过避免不必要的计算来提高性能。
如果表达式有副作用,请将赋值项左侧替换为弃元(仅限 C#)或从未使用过的局部变量。 这通过显式显示放弃未使用的值的意向来提高代码清晰度。
_ = Compute();
选项
此选项指定是首选使用放弃变量还是未使用的局部变量:
- C# - csharp_style_unused_value_expression_statement_preference
- Visual Basic - visual_basic_style_unused_value_expression_statement_preference
有关配置选项的信息,请参阅 选项格式。
csharp_style_unused_value_expression_statement_preference
财产 | 价值 | 描述 |
---|---|---|
选项名称 | csharp_style_unused_value_expression_statement_preference | |
适用的语言 | C# | |
选项值 | discard_variable |
首选将未使用的表达式分配给弃元 |
unused_local_variable |
倾向于将未使用的表达式分配给从未使用的局部变量 | |
默认选项值 | discard_variable |
// Original code:
System.Convert.ToInt32("35");
// After code fix for IDE0058:
// csharp_style_unused_value_expression_statement_preference = discard_variable
_ = System.Convert.ToInt32("35");
// csharp_style_unused_value_expression_statement_preference = unused_local_variable
var unused = Convert.ToInt32("35");
visual_basic_style_unused_value_expression_statement_preference
财产 | 价值 | 描述 |
---|---|---|
选项名称 | visual_basic_style_unused_value_expression_statement_preference | |
适用的语言 | Visual Basic | |
选项值 | unused_local_variable |
倾向于将未使用的表达式分配给从未使用的局部变量 |
默认选项值 | unused_local_variable |
' visual_basic_style_unused_value_expression_statement_preference = unused_local_variable
Dim unused = Computation()
禁止显示警告
如果只想取消单个冲突,请将预处理器指令添加到源文件以禁用,然后重新启用规则。
#pragma warning disable IDE0058
// The code that's violating the rule is on this line.
#pragma warning restore IDE0058
若要禁用文件、文件夹或项目的规则,请将其严重性设置为 配置文件中的 none
。
[*.{cs,vb}]
dotnet_diagnostic.IDE0058.severity = none
若要禁用所有代码样式规则,请将类别 Style
的严重性设置为 配置文件中的 none
。
[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Style.severity = none
有关详细信息,请参阅 如何取消代码分析警告。