Usar corpo de expressão para propriedades (IDE0025)

Artigo
11/14/2023

Propriedade	valor
ID da regra	IDE0025
Cargo	Usar corpo de expressão para propriedades
Categoria	Estilo
Subcategoria	Regras linguísticas (membros com corpo de expressão)
Línguas aplicáveis	C#
Opções	`csharp_style_expression_bodied_properties`

Descrição geral

Esta regra de estilo diz respeito ao uso de corpos de expressão versus corpos de bloco para propriedades.

Opções

Defina o valor da opção associada para esta regra para especificar se corpos de expressão ou corpos de bloco para propriedades são preferidos e, se corpos de expressão são preferidos, se eles são preferidos apenas para expressões de linha única.

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

csharp_style_expression_bodied_properties

Propriedade	valor	Description
Nome da opção	csharp_style_expression_bodied_properties
Valores de opção	`true`	Preferir corpos de expressão para propriedades
	`when_on_single_line`	Prefira corpos de expressão para propriedades quando eles forem uma única linha
	`false`	Prefira corpos de bloco para propriedades
Valor da opção padrão	`true`

// csharp_style_expression_bodied_properties = true
public int Age => _age;

// csharp_style_expression_bodied_properties = false
public int Age { get { return _age; }}

Esta regra versus IDE0027

Esta regra, IDE0025e IDE0027 (Use corpo de expressão para acessadores) são muito semelhantes. IDE0025 diz respeito ao imóvel no seu conjunto, ao passo que IDE0027 diz respeito especificamente às partes acessórias do mesmo.

Para uma propriedade somente leitura que simplesmente retorna um valor sem fazer nenhum cálculo, se IDE0025 estiver definida como mas IDE0027 estiver definida como csharp_style_expression_bodied_properties = falsecsharp_style_expression_bodied_accessors = true, você acabará com uma propriedade semelhante a esta:

public int TemperatureF
{
    get => _temp;
}

Mas se você definir como , a propriedade é simplificada ainda mais (mesmo se você definir IDE0025IDE0027 como csharp_style_expression_bodied_accessors = falsecsharp_style_expression_bodied_properties = true):

public int TemperatureF => _temp;

Para uma propriedade de leitura-gravação, a diferença torna-se um pouco mais aparente, porque a propriedade não pode ser escrita de maneira com corpo de expressão (porque consiste em mais de uma linha). Então, mesmo que IDE0025 esteja definido para csharp_style_expression_bodied_properties = true, você ainda acaba com aparelhos encaracolados, ou seja, um corpo de bloco.

Os exemplos a seguir mostram a aparência de uma propriedade com várias combinações das duas opções.

// csharp_style_expression_bodied_properties = false
// csharp_style_expression_bodied_accessors = true
public int TemperatureB
{
    get => _temp;
}

// csharp_style_expression_bodied_properties = true
// csharp_style_expression_bodied_accessors = true (or false)
public int TemperatureC => _temp;

// csharp_style_expression_bodied_properties = true (or false)
// csharp_style_expression_bodied_accessors = true
public int TemperatureD
{
    get => _temp;
    set => _temp = value;
}

// csharp_style_expression_bodied_properties = true
// csharp_style_expression_bodied_accessors = false
public int TemperatureE
{
    get
    {
        return _temp;
    }
    set
    {
        _temp = value;
    }
}

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 IDE0025
// The code that's violating the rule is on this line.
#pragma warning restore IDE0025

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

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

Para desabilitar todas as regras de estilo de código, defina a gravidade 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.

Partilhar via