Настройки круглых скобок (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_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
Дополнительные сведения см. в статье Подавление предупреждений анализа кода.
См. также
- Правила стиля кода
- Справочник по правилам стиля программирования