Adicionar modificador somente leitura (IDE0044)

Artigo
02/08/2025

Propriedade	Valor
ID da regra	IDE0044
Título	Adicionar modificador somente leitura
Categoria	Estilo
Subcategoria	Regras linguísticas (preferências de campo)
Idiomas aplicáveis	C# e Visual Basic
Introduzida a versão	Visual Studio 2017
Opções	`dotnet_style_readonly_field`

Visão geral

Esta regra de estilo diz respeito à definição do modificador readonly (C#) ou ReadOnly (Visual Basic) para campos privados que são inicializados (inline ou dentro de um construtor), mas nunca reatribuídos.

Opções

As opções especificam o comportamento que você deseja que a regra imponha . Para obter informações sobre como configurar opções, consulte Formato de opção.

dotnet_style_readonly_field

Propriedade	Valor	Descrição
Nome da opção	dotnet_style_readonly_field
Valores de opção	`true`	Prefira que os campos privados sejam marcados `readonly` se eles forem atribuídos apenas diretamente no código ou num construtor
	`false`	Não especifique nenhuma preferência sobre se os campos privados estão marcados `readonly`
Valor da opção padrão	`true`

// dotnet_style_readonly_field = true
class MyClass
{
    private readonly int _daysInYear = 365;
}

' dotnet_style_readonly_field = true
Public Class MyClass
    Private ReadOnly daysInYear As Int = 365
End Class

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

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

[*.{cs,vb}]
dotnet_diagnostic.IDE0044.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

Regras de linguagem de estilo de código
de referência de regras de estilo de código

Partilhar via