CA2226: Operatoren sollten symmetrische Überladungen aufweisen.

  • Artikel
Eigenschaft Wert
Regel-ID CA2226
Titel Operatoren sollten symmetrische Überladungen aufweisen.
Kategorie Verwendung
Fix führt oder führt nicht zur Unterbrechung Nicht unterbrechend
Standardmäßig in .NET 8 aktiviert Nein

Ursache

Ein Typ implementiert den Gleichheits- oder Ungleichheitsoperator, ohne den entgegengesetzten Operator zu implementieren.

Standardmäßig werden mit dieser Regel nur extern sichtbare Typen überprüft, aber dies ist konfigurierbar.

Regelbeschreibung

Es gibt keine Situationen, in denen entweder der Gleichheits- oder der Ungleichheitsoperator für die Instanzen eines Typs gilt und der entgegengesetzte Operator nicht definiert ist. In der Regel wird der Ungleichheitsoperator von Typen implementiert, indem Sie den negierten Wert des Gleichheitsoperators zurückgeben.

Bei Verstößen gegen diese Regel gibt der C#-Compiler eine Fehlermeldung aus.

Behandeln von Verstößen

Um einen Verstoß gegen diese Regel zu beheben, implementieren Sie sowohl den Gleichheits- als auch den Ungleichheitsoperator, oder entfernen Sie den Operator, der bereits vorhanden ist.

Wann sollten Warnungen unterdrückt werden?

Unterdrücken Sie keine Warnung dieser Regel. Wenn Sie das tun, wird Ihr Typ nicht auf eine Weise arbeiten, die mit .NET konsistent ist.

Konfigurieren des zu analysierenden Codes

Mithilfe der folgenden Option können Sie konfigurieren, für welche Teile Ihrer Codebasis diese Regel ausgeführt werden soll.

Sie können diese Optionen nur für diese Regel, für alle zutreffenden Regeln oder für alle zutreffenden Regeln in dieser Kategorie (Verwendung) konfigurieren. Weitere Informationen finden Sie unter Konfigurationsoptionen für die Codequalitätsregel.

Einschließen bestimmter API-Oberflächen

Sie können je nach Zugänglichkeit festlegen, für welche Bestandteile Ihrer Codebasis diese Regel ausgeführt wird. Sie können beispielsweise festlegen, dass die Regel nur für die nicht öffentliche API-Oberfläche ausgeführt werden soll, indem Sie einer EDITORCONFIG-Datei in Ihrem Projekt das folgende Schlüssel-Wert-Paar hinzufügen:

dotnet_code_quality.CAXXXX.api_surface = private, internal