Tornar os campos de struct graváveis (IDE0064)
Propriedade | Valor |
---|---|
ID da regra | IDE0064 |
Título | Tornar os campos de struct graváveis |
Categoria | CodeQuality |
Subcategoria | Regras de linguagem (preferências do modificador) |
Linguagens aplicáveis | C# |
Visão geral
Essa regra detecta structs contendo um ou mais campos readonly
e que também contêm uma atribuição para this
fora do construtor. A regra recomenda converter os campos readonly
para que não sejam somente leitura, ou seja, graváveis. Marcar esses campos de struct como readonly
poderá causar um comportamento inesperado porque o valor atribuído ao campo poderá ser alterado quando this
for atribuído fora do construtor.
Opções
Essa regra não tem opções de estilo de código associadas.
Exemplo
// Code with violations
struct MyStruct
{
public readonly int Value;
public MyStruct(int value)
{
Value = value;
}
public void Test()
{
this = new MyStruct(5);
}
}
// Fixed code
struct MyStruct
{
public int Value;
public MyStruct(int value)
{
Value = value;
}
public void Test()
{
this = new MyStruct(5);
}
}
Suprimir um aviso
Se você quiser suprimir apenas uma violação, adicione diretivas de pré-processador ao arquivo de origem para desabilitar e, em seguida, reabilite a regra.
#pragma warning disable IDE0064
// The code that's violating the rule is on this line.
#pragma warning restore IDE0064
Para desabilitar a regra em um arquivo, uma pasta ou um projeto, defina a severidade como none
no arquivo de configuração.
[*.{cs,vb}]
dotnet_diagnostic.IDE0064.severity = none
Para desabilitar toda essa categoria de regras, defina a gravidade da categoria como none
no arquivo de configuração.
[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-CodeQuality.severity = none
Para obter mais informações, confira Como suprimir avisos de análise de código.