다음을 통해 공유

CA1067: IEquatable을 구현할 때 등호 재정의

  • 아티클
속성 값
규칙 ID CA1067
제목 IEquatable을 구현할 때 Equals를 재정의하세요.
범주 디자인
수정 사항이 주요 변경인지 여부 주요 변경 아님
.NET 9에서 기본적으로 사용 제안 사항

원인

형식은 IEquatable<T>을 구현하지만 Equals 메서드를 재정의하지 않습니다.

규칙 설명

IEquatable<T> 인터페이스를 구현하는 형식은 형식의 두 인스턴스가 같은지 비교하는 작업을 지원함을 나타냅니다. 또한 해당 동작이 System.IEquatable<T>.Equals 구현의 동작과 일치하도록 Equals 및 GetHashCode() 메서드의 기본 클래스 구현을 재정의해야 합니다. 자세한 내용은 여기를 참조하세요.

Equals 구현은 System.IEquatable<T>.Equals 구현과 일치하는 결과를 반환해야 합니다.

위반 문제를 해결하는 방법

위반 문제를 해결하려면 Equals를 재정의하고 System.IEquatable<T>.Equals 구현을 호출하여 메서드를 구현합니다. 예를 들어 다음 두 코드 조각은 규칙의 위반과 위반을 해결하는 방법을 보여 줍니다.

using System;

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

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

using System;

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

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

    public override bool Equals(object obj)
        => obj is S objS && Equals(objS);

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

경고를 표시하지 않는 경우

이 규칙의 위반을 표시하지 않습니다.

참고 항목