ValueType.Equals(Object) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Geeft aan of dit exemplaar en een opgegeven object gelijk zijn.
public:
override bool Equals(System::Object ^ obj);public override bool Equals(object obj);public override bool Equals(object? obj);override this.Equals : obj -> boolPublic Overrides Function Equals (obj As Object) As BooleanParameters
- obj
- Object
Het object dat moet worden vergeleken met het huidige exemplaar.
Retouren
trueals obj en dit exemplaar hetzelfde type zijn en dezelfde waarde vertegenwoordigen; anders. false
Voorbeelden
In het volgende voorbeeld ziet u hoe de Equals methode kan worden overschreven door een afgeleid waardetype.
public struct Complex
{
public double m_Re;
public double m_Im;
public override bool Equals( object ob ){
if( ob is Complex ) {
Complex c = (Complex) ob;
return m_Re==c.m_Re && m_Im==c.m_Im;
}
else {
return false;
}
}
public override int GetHashCode(){
return m_Re.GetHashCode() ^ m_Im.GetHashCode();
}
}
type Complex() =
member val m_Re = 0. with get, set
member val m_Im = 0. with get, set
override this.Equals(ob) =
match ob with
| :? Complex as c ->
this.m_Re = c.m_Re && this.m_Im = c.m_Im
| _ -> false
override this.GetHashCode() =
this.m_Re.GetHashCode() ^^^ this.m_Im.GetHashCode()
Public Structure Complex
Private m_Re As Double
Private m_Im As Double
Public Overloads Function Equals(ob As Object) As Boolean
If TypeOf ob Is Complex Then
Dim c As Complex = CType(ob, Complex)
Return m_Re = c.m_Re And m_Im = c.m_Im
Else
Return False
End If
End Function
Public Overloads Function GetHashCode() As Integer
Return m_Re.GetHashCode() ^ m_Im.GetHashCode()
End Function
End Structure
Opmerkingen
De methode ValueType.Equals(Object) overschrijft Object.Equals(Object) en biedt de standaard implementatie van waarde gelijkheid voor alle waardetypen in .NET.
De standaard implementatie roept elk veld van het huidige exemplaar aan en Object.Equals(Object) retourneert objtrue als alle velden gelijk zijn.
.NET 9 en hoger wordt de standaardimplementatie van ValueType.Equals(Object)NotSupportedException als InlineArrayAttribute wordt toegepast op het type.
Important
Met name als uw waardetype velden bevat die verwijzingstypen zijn, moet u de Equals(Object) methode overschrijven. Dit kan de prestaties verbeteren en u in staat stellen om de betekenis van gelijkheid voor het type nauwkeuriger weer te geven.
Notities voor Windows Runtime
Wanneer u de methode Equals aanroept in een Windows Runtime-structuur, biedt het standaardgedrag voor waardetypen die Equals niet overschrijven. Dit maakt deel uit van de ondersteuning die .NET biedt voor De Windows Runtime (zie .NET-ondersteuning voor Windows Store-apps en Windows Runtime). Windows Runtime structuren kunnen Equals niet overschrijven, zelfs niet als ze zijn geschreven met C# of Visual Basic, omdat ze geen methoden kunnen hebben. (Bovendien nemen structuren in de Windows Runtime zelf geen ValueType over.) Ze lijken echter ToString, Equals en GetHashCode methoden te hebben wanneer u ze in uw C# of Visual Basic code gebruikt, en .NET biedt het standaardgedrag voor deze methoden.
