Partilhar via

Preferências para parênteses (IDE0047 e IDE0048)

  • Artigo

Este artigo descreve duas regras relacionadas, IDE0047 e IDE0048.

Propriedade Valor
ID da regra IDE0047
Título Remover parênteses desnecessários
Categoria Estilo
Subcategoria Regras linguísticas (preferências entre parênteses)
Idiomas aplicáveis C# e Visual Basic
Versão introduzida Visual Studio 2017
Opções 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
Propriedade Valor
ID da regra IDE0048
Título Adicionar parênteses para maior clareza
Categoria Estilo
Subcategoria Regras linguísticas (preferências entre parênteses)
Idiomas aplicáveis C# e Visual Basic
Versão introduzida Visual Studio 2017
Opções 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

Visão geral

As regras de estilo nesta secção dizem respeito às preferências de parênteses, incluindo o uso de parênteses para esclarecer a precedência de operadores aritméticos, relacionais e outros binários .

Opções

Esta regra tem opções associadas para especificar preferências com base no tipo de operador:

Para obter informações sobre como configurar opções, consulte Formato de opção.

dotnet_style_parentheses_in_arithmetic_binary_operators

Propriedade Valor Descrição
Nome da opção dotnet_style_parentheses_in_arithmetic_binary_operators
Valores de opção always_for_clarity Prefira parênteses para esclarecer a precedência do operador aritmético
never_if_unnecessary Prefira não parênteses quando a precedência do operador aritmético é óbvia
Valor da opção padrão always_for_clarity

Os operadores binários aritméticos são: *, /, %, +, -, <<, >>, &, ^e |.

// 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

Propriedade Valor Descrição
Nome da opção dotnet_style_parentheses_in_relational_binary_operators
Valores de opção always_for_clarity Prefira parênteses para esclarecer a precedência do operador relacional
never_if_unnecessary Prefira não ter parênteses quando a precedência do operador relacional é óbvia
Valor da opção padrão always_for_clarity

Os operadores binários relacionais são: >, <, <=, >=, is, as, ==e !=.

// 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

Propriedade Valor Descrição
Nome da opção dotnet_style_parentheses_in_other_binary_operators
Valores de opção always_for_clarity Prefira parênteses para esclarecer a precedência de outros operadores binários
never_if_unnecessary Prefira não ter parênteses quando a precedência de outro operador binário é óbvia
Valor da opção padrão always_for_clarity

Os outros operadores binários são: &&, ||e ??.

// 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

Propriedade Valor Descrição
Nome da opção dotnet_style_parentheses_in_other_operators
Valores de opção always_for_clarity Prefira parênteses para esclarecer a precedência de outros operadores
never_if_unnecessary Prefira não ter parênteses quando a precedência de outro operador é óbvia
Valor da opção padrão never_if_unnecessary

Esta opção aplica-se a operadores exceto os seguintes:

*, /, %, +, -, <<, >>, &, ^, |>, <, <=, >=, 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

Suprimir um aviso

Se você quiser suprimir apenas uma única violação, adicione diretivas de pré-processador ao arquivo de origem para desativar e, em seguida, reativar a regra.

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

Para desabilitar a regra para um arquivo, pasta ou projeto, defina sua gravidade como none no arquivo de configuração .

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

Para desabilitar todas as regras de estilo de código, defina a severidade da categoria Style como none no arquivo de configuração .

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

Para obter mais informações, consulte Como suprimir avisos de análise de código.

Ver também