IEqualityComparer.Equals(Object, Object) Methode

Definition

Namespace:

System.Collections

Assembly:

System.Runtime.dll

Bestimmt, ob die angegebenen Objekte gleich sind.

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

Parameter

x

Object

Das erste zu vergleichende Objekt.

y

Object

Das zweite zu vergleichende Objekt.

Gibt zurück

Boolean

true, wenn die angegebenen Objekte gleich sind, andernfalls false.

Ausnahmen

ArgumentException

x und y sind nicht vom gleichen Typ. Keines der beiden kann einen Vergleich mit dem jeweils anderen Objekt behandeln.

Beispiele

Im folgenden Codebeispiel wird die Implementierung einer nicht beachteten IEqualityComparerGroß-/Kleinschreibung veranschaulicht. In diesem Beispiel wird die CaseInsensitiveComparer.Compare -Methode verwendet, um basierend auf dem bereitgestellten CultureInfozu bestimmen, ob zwei -Objekte gleich sind.

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

Hinweise

Implementieren Sie diese Methode, um einen benutzerdefinierten Gleichheitsvergleich für Objekte bereitzustellen.

Hinweise für Ausführende

Die Equals(Object, Object) Methode ist reflexiv, symmetrisch und transitiv. Das heißt, es wird zurückgegebentrue, wenn es zum Vergleichen eines Objekts mit sich selbst verwendet wird; true für zwei Objekte x und y , wenn es für y und xisttrue; und true für zwei Objekte x und z , wenn es true für x und y ist und auch true für y und z.

Implementierungen sind erforderlich, um sicherzustellen, dass, wenn die Equals(Object, Object) Methode für zwei -Objekte x und yzurückgibttrue, der von der GetHashCode(Object) -Methode für x zurückgegebene Wert dem für yzurückgegebenen Wert entsprechen muss.