CA1822: Marcar membros como estáticos

  • Artigo
Property Valor
ID da regra CA1822
Título Marcar membros como estáticos
Categoria Desempenho
A correção é com ou sem interrupção Sem interrupção – se o membro não estiver visível fora do assembly, independentemente da alteração que você fizer.

Sem interrupção – se você apenas alterar o membro para um membro de instância com a palavra-chave this.

Com interrupção – se você alterar o membro de um membro de instância para um membro estático e ele estiver visível fora do assembly.
Habilitado por padrão no .NET 8 Como sugestão

Causa

Um membro que não acessa dados de instância não está marcado como estático (compartilhado no Visual Basic).

Descrição da regra

Os membros que não acessam dados de instância ou chamam métodos de instância podem ser marcados como estáticos (Shared no Visual Basic). Depois que você marcar os métodos como estáticos, o compilador emitirá sites de chamada não virtuais para esses membros. A emissão de sites de chamadas não ambientais impedirá uma verificação em tempo de execução para cada chamada que verifique se o ponteiro do objeto atual não é nulo. Isso pode levar a um ganho de desempenho mensurável para o código sensível ao desempenho. Em alguns casos, a falha ao acessar a instância de objeto atual representa um problema de correção.

Como corrigir violações

Marque o membro como estático (ou Compartilhado no Visual Basic) ou use 'this'/'Me' no corpo do método, se apropriado.

Quando suprimir avisos

É seguro suprimir um aviso dessa regra para o código enviado anteriormente para o qual a correção seria uma alteração interruptiva.

Suprimir um aviso

Para suprimir apenas uma violação, adicione diretivas de pré-processador ao arquivo de origem a fim de desabilitar e, em seguida, reabilitar a regra.

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

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.CA1822.severity = none

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

Configurar código para analisar

Use a opção a seguir para configurar em quais partes da base de código essa regra deve ser executada.

Você pode configurar essa opção apenas para essa regra, para todas as regras às quais ela se aplica ou para todas as regras nessa categoria (Desempenho) às quais ela se aplica. Para saber mais, confira Opções de configuração de regra de qualidade de código.

Incluir superfícies de API específicas

É possível configurar em quais partes da base de código essa regra deverá ser executada, com base na acessibilidade. Por exemplo, para especificar que a regra deverá ser executada apenas na superfície de API não pública, adicione o seguinte par chave-valor a um arquivo .editorconfig no projeto:

dotnet_code_quality.CAXXXX.api_surface = private, internal