CA2226 : Les opérateurs doivent contenir des surcharges symétriques
Propriété | Value |
---|---|
Identificateur de la règle | CA2226 |
Titre | Les opérateurs doivent contenir des surcharges symétriques |
Catégorie | Utilisation |
Le correctif est cassant ou non cassant | Sans rupture |
Activé par défaut dans .NET 8 | Non |
Cause
Un type implémente l'opérateur d'égalité ou d'inégalité et n'implémente pas l'opérateur opposé.
Par défaut, cette règle examine uniquement les types visibles en externe, mais elle est configurable.
Description de la règle
Il n’existe aucune situation dans laquelle l’égalité ou l’inégalité s’applique aux instances d’un type, et l’opérateur opposé n’est pas défini. Les types implémentent généralement l’opérateur d’inégalité en retournant la valeur inversée de l’opérateur d’égalité.
Le compilateur C# émet une erreur pour les violations de cette règle.
Comment corriger les violations
Pour corriger une violation de cette règle, implémentez les opérateurs d’égalité et d’inégalité, ou supprimez celui qui est présent.
Quand supprimer les avertissements
Ne supprimez aucun avertissement de cette règle. Si c’est le cas, votre type ne fonctionnera pas d’une manière cohérente avec .NET.
Configurer le code à analyser
Utilisez l’option suivante pour configurer les parties de votre codebase sur lesquelles exécuter cette règle.
Vous pouvez configurer cette option pour cette règle uniquement, pour toutes les règles auxquelles elle s’applique ou pour toutes les règles de cette catégorie (Utilisation) auxquelles elle s’applique. Pour plus d’informations, consultez Options de configuration des règles de qualité du code.
Inclure des surfaces d’API spécifiques
Vous pouvez configurer les parties de votre codebase sur lesquelles exécuter cette règle, en fonction de leur accessibilité. Par exemple, pour spécifier que la règle doit s’exécuter uniquement sur la surface d’API non publique, ajoutez la paire clé-valeur suivante à un fichier .editorconfig dans votre projet :
dotnet_code_quality.CAXXXX.api_surface = private, internal