括弧喜好設定 (IDE0047 和 IDE0048)

發行項
06/08/2023

本文描述兩個相關規則 IDE0047 和 IDE0048。

屬性	值
規則識別碼	IDE0047
標題	移除不必要的括弧
類別	樣式
子類別	語言規則 (括弧喜好設定)
適用語言	C# 和 Visual Basic
引進的版本	Visual Studio 2017
選項	`dotnet_style_parentheses_in_arithmetic_binary_operators`
	`dotnet_style_parentheses_in_relational_binary_operators`
	`dotnet_style_parentheses_in_other_binary_operators`
	`dotnet_style_parentheses_in_other_operators`

屬性	值
規則識別碼	IDE0048
標題	新增括弧以明確表示
類別	樣式
子類別	語言規則 (括弧喜好設定)
適用語言	C# 和 Visual Basic
引進的版本	Visual Studio 2017
選項	`dotnet_style_parentheses_in_arithmetic_binary_operators`
	`dotnet_style_parentheses_in_relational_binary_operators`
	`dotnet_style_parentheses_in_other_binary_operators`
	`dotnet_style_parentheses_in_other_operators`

概觀

本節中的樣式規則與括弧喜好設定有關，包括使用括弧來說明算數、關係及其他二元運算子的優先順序。

選項

此規則具有根據運算子類型指定喜好設定的相關選項：

算術二元運算子 - dotnet_style_parentheses_in_arithmetic_binary_operators
關係二元運算子 - dotnet_style_parentheses_in_relational_binary_operators
其他二元運算子 - dotnet_style_parentheses_in_other_binary_operators
其他運算子 - dotnet_style_parentheses_in_other_operators

如需設定選項的資訊，請參閱選項格式。

dotnet_style_parentheses_in_arithmetic_binary_operators

屬性	值	描述
選項名稱	dotnet_style_parentheses_in_arithmetic_binary_operators
選項值	`always_for_clarity`	建議使用括弧來說明算術運算子優先順序
	`never_if_unnecessary`	當算術運算子優先順序很明顯時建議不使用括弧
預設選項值	`always_for_clarity`

算術二元運算子包括：*、/、%、+、-、<<、>>、&、^ 和 |。

// dotnet_style_parentheses_in_arithmetic_binary_operators = always_for_clarity
var v = a + (b * c);

// dotnet_style_parentheses_in_arithmetic_binary_operators = never_if_unnecessary
var v = a + b * c;

' dotnet_style_parentheses_in_arithmetic_binary_operators = always_for_clarity
Dim v = a + (b * c)

' dotnet_style_parentheses_in_arithmetic_binary_operators = never_if_unnecessary
Dim v = a + b * c

dotnet_style_parentheses_in_relational_binary_operators

屬性	值	描述
選項名稱	dotnet_style_parentheses_in_relational_binary_operators
選項值	`always_for_clarity`	建議使用括弧來說明關係運算子優先順序
	`never_if_unnecessary`	當關係運算子優先順序很明顯時建議不使用括弧
預設選項值	`always_for_clarity`

關係二元運算子包括：>、<、<=、>=、is、as、== 和 !=。

// dotnet_style_parentheses_in_relational_binary_operators = always_for_clarity
var v = (a < b) == (c > d);

// dotnet_style_parentheses_in_relational_binary_operators = never_if_unnecessary
var v = a < b == c > d;

' dotnet_style_parentheses_in_relational_binary_operators = always_for_clarity
Dim v = (a < b) = (c > d)

' dotnet_style_parentheses_in_relational_binary_operators = never_if_unnecessary
Dim v = a < b = c > d

dotnet_style_parentheses_in_other_binary_operators

屬性	值	描述
選項名稱	dotnet_style_parentheses_in_other_binary_operators
選項值	`always_for_clarity`	建議使用括弧來說明其他二元運算子優先順序
	`never_if_unnecessary`	當其他二元運算子優先順序很明顯時建議不使用括弧
預設選項值	`always_for_clarity`

其他二元運算子包括：&&、|| 和 ??。

// dotnet_style_parentheses_in_other_binary_operators = always_for_clarity
var v = a || (b && c);

// dotnet_style_parentheses_in_other_binary_operators = never_if_unnecessary
var v = a || b && c;

' dotnet_style_parentheses_in_other_binary_operators = always_for_clarity
Dim v = a OrElse (b AndAlso c)

' dotnet_style_parentheses_in_other_binary_operators = never_if_unnecessary
Dim v = a OrElse b AndAlso c

dotnet_style_parentheses_in_other_operators

屬性	值	描述
選項名稱	dotnet_style_parentheses_in_other_operators
選項值	`always_for_clarity`	建議使用括弧來說明其他運算子優先順序
	`never_if_unnecessary`	當其他運算子優先順序很明顯時建議不使用括弧
預設選項值	`never_if_unnecessary`

此選項適用於下列運算子「以外」的運算子：

*, /, %, +, -, <<, >>, &, ^, |>, <, <=, >=, is, as, ==, !=&&, ||, ??

// dotnet_style_parentheses_in_other_operators = always_for_clarity
var v = (a.b).Length;

// dotnet_style_parentheses_in_other_operators = never_if_unnecessary
var v = a.b.Length;

' dotnet_style_parentheses_in_other_operators = always_for_clarity
Dim v = (a.b).Length

' dotnet_style_parentheses_in_other_operators = never_if_unnecessary
Dim v = a.b.Length

隱藏警告

若您只想隱藏單一違規，請將前置處理指示詞新增至來源檔案以停用規則，然後重新啟用規則。

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

若要停用檔案、資料夾或專案的規則，請在組態檔中將其嚴重性設定為 none。

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

若要停用所有程式碼樣式規則，請在組態檔中將類別 Style 的嚴重性設定為 none。

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

如需詳細資訊，請參閱如何隱藏程式碼分析警告。

共用方式為