CA2226: Operadores devem ter sobrecargas simétricas
Property | Valor |
---|---|
ID da regra | CA2226 |
Título | Operadores devem ter sobrecargas simétricas |
Categoria | Usage |
Correção interruptiva ou sem interrupção | Sem interrupção |
Habilitado por padrão no .NET 9 | Não |
Causa
Um tipo implementa o operador de igualdade ou de desigualdade e não implementa o operador oposto.
Por padrão, essa regra analisa apenas os tipos visíveis externamente, mas isso é configurável.
Descrição da regra
Não há circunstâncias em que a igualdade ou a desigualdade seja aplicável a instâncias de um tipo e o operador oposto seja indefinido. Os tipos normalmente implementam o operador de desigualdade retornando o valor negado do operador de igualdade.
O compilador C# emite um erro para violações dessa regra.
Como corrigir violações
Para corrigir uma violação dessa regra, implemente os operadores de igualdade e desigualdade ou remova aquele que está presente.
Quando suprimir avisos
Não suprima um aviso nessa regra. Se você fizer isso, seu tipo não funcionará de maneira consistente com o .NET.
Configurar códigos para análises
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 (Uso) à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