IEqualityComparer.Equals(Object, Object) 方法

定义

确定指定的对象是否相等。Determines whether the specified objects are equal.

public:
 bool Equals(System::Object ^ x, System::Object ^ y);
public bool Equals (object x, object y);
abstract member Equals : obj * obj -> bool
Public Function Equals (x As Object, y As Object) As Boolean

参数

x
Object

要比较的第一个对象。The first object to compare.

y
Object

要比较的第二个对象。The second object to compare.

返回

如果指定的对象相等,则为 true;否则为 falsetrue if the specified objects are equal; otherwise, false.

异常

xy 的类型不同,它们都无法处理与另一个进行的比较。x and y are of different types and neither one can handle comparisons with the other.

示例

下面的代码示例演示如何实现不区分IEqualityComparer大小写。The following code example demonstrates the implementation of a case-insensitive IEqualityComparer. 在此示例中, CaseInsensitiveComparer.Compare方法用于根据提供CultureInfo的确定两个对象是否相等。In this example, the CaseInsensitiveComparer.Compare method is used to determine whether two objects are equal, based on the provided CultureInfo.

ref class myCultureComparer : IEqualityComparer
{
private:
    CaseInsensitiveComparer^ myComparer;

public:
    myCultureComparer()
    {
        myComparer = CaseInsensitiveComparer::DefaultInvariant;
    }

    myCultureComparer(CultureInfo^ myCulture)
    {
        myComparer = gcnew CaseInsensitiveComparer(myCulture);
    }

    virtual bool Equals(Object^ x, Object^ y) 
    {
        if (myComparer->Compare(x, y) == 0)
        {
            return true;
        }
        else
        {
            return false;
        }
    }

    virtual int GetHashCode(Object^ obj)
    {
        return obj->ToString()->ToLower()->GetHashCode();
    }
};
class myCultureComparer : IEqualityComparer
{
    public CaseInsensitiveComparer myComparer;

    public myCultureComparer()
    {
        myComparer = CaseInsensitiveComparer.DefaultInvariant;
    }

    public myCultureComparer(CultureInfo myCulture)
    {
        myComparer = new CaseInsensitiveComparer(myCulture);
    }

    public new bool Equals(object x, object y)
    {
        return myComparer.Compare(x, y) == 0;
    }

    public int GetHashCode(object obj)
    {
        return obj.ToString().ToLower().GetHashCode();
    }
}
Public Class myCultureComparer
    Implements IEqualityComparer

    Dim myComparer As CaseInsensitiveComparer

    Public Sub New()
        myComparer = CaseInsensitiveComparer.DefaultInvariant
    End Sub

    Public Sub New(ByVal myCulture As CultureInfo)
        myComparer = New CaseInsensitiveComparer(myCulture)
    End Sub

    Public Function Equals1(ByVal x As Object, ByVal y As Object) _
        As Boolean Implements IEqualityComparer.Equals

        Return myComparer.Compare(x, y) = 0
    End Function

    Public Function GetHashCode1(ByVal obj As Object) _
        As Integer Implements IEqualityComparer.GetHashCode
        Return obj.ToString().ToLower().GetHashCode()
    End Function
End Class

注解

实现此方法可为对象提供自定义的相等比较。Implement this method to provide a customized equality comparison for objects.

实施者说明

Equals(Object, Object)方法为自反、对称和可传递。The Equals(Object, Object) method is reflexive, symmetric, and transitive. 也就是说, 如果用于将true对象与其自身进行比较, 则返回; 否则返回。y true x对于两个x对象, 如果它true适用y于和x, true则为; 对于两个对象, 则为; 如果它用于, 则为。 true x和以及和zy true yThat is, it returns true if used to compare an object with itself; true for two objects x and y if it is true for y and x; and true for two objects x and z if it is true for x and y and also true for y and z.

Equals(Object, Object)实现需要确保如果方法为两个对象x y GetHashCode(Object)true返回, 则的方法x返回的值必须等于为返回的值y.Implementations are required to ensure that if the Equals(Object, Object) method returns true for two objects x and y, then the value returned by the GetHashCode(Object) method for x must equal the value returned for y.

适用于