CA1066: Implement IEquatable when overriding Equals

Cause

A value type (struct) overrides Equals method, but does not implement IEquatable<T>.

Rule description

A value type overriding Equals method indicates that it supports comparing two instances of the type for value equality. Consider implementing the IEquatable<T> interface to support strongly typed tests for equality. This ensures that callers performing equality checks invoke the strongly typed System.IEquatable<T>.Equals method and avoid boxing the argument, improving performance. For more information, see Notes to implementers.

Your System.IEquatable<T>.Equals implementation should return results that are consistent with Equals.

How to fix violations

To fix a violation, implement IEquatable<T> and update Equals override to invoke this implemented method. For example, the following two code snippets show a violation of the rule and how to fix it:

public struct S
{
 private readonly int _value;
 public S(int f)
 {
 _value = f;
 }

 public override int GetHashCode()
 => _value.GetHashCode();

 public override bool Equals(object other)
 => other is S otherS && _value == otherS._value;
}

using System;

public struct S : IEquatable<S>
{
 private readonly int _value;
 public S(int f)
 {
 _value = f;
 }

 public override int GetHashCode()
 => _value.GetHashCode();

 public override bool Equals(object other)
 => other is S otherS && Equals(otherS);

 public bool Equals(S other)
 => _value == other._value;
}

When to suppress warnings

It is safe to suppress violations from this rule if the design and performance benefits from implementing the interface are not critical.

Suppress a warning

If you just want to suppress a single violation, add preprocessor directives to your source file to disable and then re-enable the rule.

#pragma warning disable CA1066
// The code that's violating the rule is on this line.
#pragma warning restore CA1066

To disable the rule for a file, folder, or project, set its severity to none in the configuration file.

[*.{cs,vb}]
dotnet_diagnostic.CA1066.severity = none

For more information, see How to suppress code analysis warnings.

Related rules

• CA1067: Override Equals when implementing IEquatable

See also

• Design rules