Share via

CA2226: Operatorer bör ha symmetriska överlagringar

  • Artikel
Property Värde
Regel-ID CA2226
Rubrik Operatorer bör ha symmetriska överlagringar
Kategori Användning
Korrigeringen är icke-bakåtkompatibel Icke-icke-bryta
Aktiverad som standard i .NET 8 Nej

Orsak

En typ implementerar likhets- eller ojämlikhetsoperatorn och implementerar inte den motsatta operatorn.

Som standard tittar den här regeln bara på externt synliga typer, men det kan konfigureras.

Regelbeskrivning

Det finns inga omständigheter där vare sig likhet eller ojämlikhet gäller för instanser av en typ, och den motsatta operatorn är odefinierad. Typer implementerar vanligtvis ojämlikhetsoperatorn genom att returnera det negerade värdet för likhetsoperatorn.

C#-kompilatorn utfärdar ett fel vid överträdelser av den här regeln.

Så här åtgärdar du överträdelser

Om du vill åtgärda ett brott mot den här regeln implementerar du både likhets- och ojämlikhetsoperatorerna eller tar bort den som finns.

När du ska ignorera varningar

Ignorera inte en varning från den här regeln. Om du gör det fungerar inte din typ på ett sätt som är konsekvent med .NET.

Konfigurera kod för analys

Använd följande alternativ för att konfigurera vilka delar av kodbasen som regeln ska köras på.

Du kan konfigurera det här alternativet för bara den här regeln, för alla regler som den gäller för eller för alla regler i den här kategorin (användning) som den gäller för. Mer information finns i Konfigurationsalternativ för kodkvalitetsregel.

Inkludera specifika API-ytor

Du kan konfigurera vilka delar av kodbasen som ska köras med den här regeln baserat på deras tillgänglighet. Om du till exempel vill ange att regeln endast ska köras mot den icke-offentliga API-ytan lägger du till följande nyckel/värde-par i en .editorconfig-fil i projektet:

dotnet_code_quality.CAXXXX.api_surface = private, internal