Поделиться через


Настройки круглых скобок (IDE0047 и IDE0048)

В этой статье описаны два связанных правила, 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_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_в_прочих_операторах

Свойство Ценность Описание
название опции 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

Дополнительные сведения см. в статье Подавление предупреждений анализа кода.

См. также