| 财产 | 价值 |
|---|---|
| 规则 ID | IDE0059 |
| 标题 | 删除不必要的值分配 |
| 类别 | 样式 |
| 子类别 | 不必要的代码规则(表达式级首选项) |
| 适用的语言 | C# 和 Visual Basic |
| 选项 | csharp_style_unused_value_assignment_preference |
visual_basic_style_unused_value_assignment_preference |
概述
此规则标记不必要的值分配。 例如:
// IDE0059: value written to 'v' is never
// read, so assignment to 'v' is unnecessary.
int v = Compute();
v = Compute2();
您可以采取以下操作之一来修复此违规:
如果赋值右侧的表达式没有副作用,请删除表达式或整个赋值语句。 这通过避免不必要的计算来提高性能。
int v = Compute2();如果赋值项右侧的表达式有副作用,请将赋值项左侧替换为从未使用过的弃元(仅限 C#)或局部变量。 通过明确展示丢弃未使用值的意图,丢弃操作可以提高代码的清晰度。
_ = Compute(); int v = Compute2();
已知的限制
此规则在某些代码上下文中不起作用。 分析器无法在以下方案中标记不必要的值分配:
- 向
try或catch块分配任务。 -
using语句块内的赋值。 - 在 lambda 表达式或委托正文中分配的变量。
- 存在表达式树时的变量(
Expression<Func<T>>)。
以下 GitHub 问题跟踪这些限制:
- IDE0059并不总是报告
- 检测 IDE0059 在 try/catch 语句中的效果不佳
- IDE0059 没有在包含 `using` 关键字的代码块中被触发
- IDE0059不适用于表达式树
- 删除未使用的变量/值(父问题)
选项
此选项指定是首选使用放弃变量还是未使用的局部变量:
- C# - csharp_style_unused_value_assignment_preference
- Visual Basic - 未使用值的分配偏好设置
有关配置选项的信息,请参阅 选项格式。
csharp_style_unused_value_assignment_preference
| 财产 | 价值 | 描述 |
|---|---|---|
| 选项名称 | csharp_style_unused_value_assignment_preference | |
| 适用的语言 | C# | |
| 选项值 | discard_variable |
在分配未使用的值时,首选使用弃元 |
unused_local_variable |
分配未使用的值时,首选使用局部变量 | |
| 默认选项值 | discard_variable |
// csharp_style_unused_value_assignment_preference = discard_variable
int GetCount(Dictionary<string, int> wordCount, string searchWord)
{
_ = wordCount.TryGetValue(searchWord, out var count);
return count;
}
// csharp_style_unused_value_assignment_preference = unused_local_variable
int GetCount(Dictionary<string, int> wordCount, string searchWord)
{
var unused = wordCount.TryGetValue(searchWord, out var count);
return count;
}
visual_basic_style_unused_value_assignment_preference
| 财产 | 价值 | 描述 |
|---|---|---|
| 选项名称 | visual_basic_style_unused_value_assignment_preference | |
| 适用的语言 | Visual Basic | |
| 选项值 | unused_local_variable |
分配未使用的值时,首选使用局部变量 |
| 默认选项值 | unused_local_variable |
' visual_basic_style_unused_value_assignment_preference = unused_local_variable
Dim unused = Computation()
禁止显示警告
如果只想取消单个冲突,请将预处理器指令添加到源文件以禁用,然后重新启用规则。
#pragma warning disable IDE0059
// The code that's violating the rule is on this line.
#pragma warning restore IDE0059
若要禁用文件、文件夹或项目的规则,请将其严重性设置为 none中的 。
[*.{cs,vb}]
dotnet_diagnostic.IDE0059.severity = none
若要禁用所有代码样式规则,请将类别 Style 的严重性设置为 none中的 。
[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Style.severity = none
有关详细信息,请参阅 如何取消代码分析警告。
| 财产 | 价值 |
|---|---|
| 规则 ID | IDE0059 |
| 标题 | 该值未使用 |
| 类别 | 样式 |
| 适用的语言 | F# |
| 选项 | 没有 |
概述
此规则标记不必要的值分配。 例如,以下代码片段中未使用 answer:
type T() =
let answer = 42