CA2226 : Les opérateurs doivent contenir des surcharges symétriques

  • Article
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