删除不必要的表达式值 (IDE0058)
属性 | 值 |
---|---|
规则 ID | IDE0058 |
标题 | 删除不必要的表达式值 |
类别 | Style |
Subcategory | 语言规则(表达式级首选项) |
适用的语言 | 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
Property | 值 | 说明 |
---|---|---|
选项名称 | 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
Property | 值 | 说明 |
---|---|---|
选项名称 | 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
有关详细信息,请参阅如何禁止显示代码分析警告。