CA1822: Marcar membros como estáticos
| Property | valor |
|---|---|
| ID da regra | CA1822 |
| Título | Marcar membros como estáticos |
| Categoria | Desempenho |
| A correção está quebrando ou não quebrando | Sem quebra - Se o membro não estiver visível fora da assembleia, independentemente da alteração que fizer. Non-breaking - Se você apenas alterar o membro para um membro da instância com a this palavra-chave.Quebra - Se você alterar o membro de um membro da instância para um membro estático e ele estiver visível fora do assembly. |
| Habilitado por padrão no .NET 9 | Como sugestão |
Motivo
Um membro que não acessa dados de instância não é marcado como estático (compartilhado no Visual Basic).
Descrição da regra
Os membros que não acessam dados de instância ou métodos de instância de chamada podem ser marcados como estáticos (Compartilhado no Visual Basic). Depois de 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 chamada não virtuais impedirá uma verificação em tempo de execução para cada chamada que garante que o ponteiro do objeto atual não seja nulo. Isso pode obter um ganho de desempenho mensurável para código sensível ao desempenho. Em alguns casos, a falha ao acessar a instância do 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 desta regra para o código enviado anteriormente para o qual a correção seria uma alteração de quebra.
Suprimir um aviso
Se você quiser apenas suprimir uma única violação, adicione diretivas de pré-processador ao seu arquivo de origem para desativar e, em seguida, reativar 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 de um arquivo, pasta ou projeto, defina sua gravidade como none no arquivo de configuração.
[*.{cs,vb}]
dotnet_diagnostic.CA1822.severity = none
Para obter mais informações, consulte Como suprimir avisos de análise de código.
Configurar código para análise
Use a opção a seguir para configurar em quais partes da sua base de código executar essa regra.
Você pode configurar essa opção apenas para esta regra, para todas as regras às quais ela se aplica ou para todas as regras nesta categoria (Desempenho) às quais ela se aplica. Para obter mais informações, consulte Opções de configuração da regra de qualidade de código.
Incluir superfícies de API específicas
Você pode configurar em quais partes da sua base de código executar essa regra, com base em sua acessibilidade. Por exemplo, para especificar que a regra deve ser executada somente na superfície de API não pública, adicione o seguinte par chave-valor a um arquivo .editorconfig em seu projeto:
dotnet_code_quality.CAXXXX.api_surface = private, internal
