ValueType.Equals(Object) Method


이 인스턴스와 지정된 개체가 같은지를 나타냅니다.Indicates whether this instance and a specified object are equal.

 override bool Equals(System::Object ^ obj);
public override bool Equals (object obj);
override this.Equals : obj -> bool
Public Overrides Function Equals (obj As Object) As Boolean



현재 인스턴스와 비교할 개체입니다.The object to compare with the current instance.



true와 이 인스턴스가 동일한 형식이고 동일한 값을 나타내면 obj이고, 그렇지 않으면 false입니다.true if obj and this instance are the same type and represent the same value; otherwise, false.


다음 예제에서는 파생 된 값 형식으로 Equals 메서드를 재정의할 수 있는 방법을 보여 줍니다.The following example demonstrates how the Equals method can be overridden by a derived value type.

public ref struct Complex
   double m_Re;
   double m_Im;
   virtual bool Equals( Object^ ob ) override
      if ( dynamic_cast<Complex^>(ob) )
         Complex^ c = dynamic_cast<Complex^>(ob);
         return m_Re == c->m_Re && m_Im == c->m_Im;
         return false;

   virtual int GetHashCode() override
      return m_Re.GetHashCode() ^ m_Im.GetHashCode();
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();
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
         Return False
      End If
   End Function
   Public Overloads Function GetHashCode() As Integer
      Return m_Re.GetHashCode() ^ m_Im.GetHashCode()
   End Function

End Structure


ValueType.Equals(Object) 메서드는 Object.Equals(Object)를 재정의 하 고 .NET Framework의 모든 값 형식에 대 한 값 같음의 기본 구현을 제공 합니다.The ValueType.Equals(Object) method overrides Object.Equals(Object) and provides the default implementation of value equality for all value types in the .NET Framework.

기본 구현에서는 현재 인스턴스의 각 필드 및 obj Object.Equals(Object)를 호출 하 고 모든 필드가 동일한 경우 true을 반환 합니다.The default implementation calls Object.Equals(Object) on each field of the current instance and obj and returns true if all fields are equal.


특히 값 형식에 참조 형식인 필드가 포함 된 경우 Equals(Object) 메서드를 재정의 해야 합니다.Particularly if your value type contains fields that are reference types, you should override the Equals(Object) method. 성능이 향상 되 고 보다 자세히 유형에 대 한 같음의 의미를 나타내는 수이 있습니다.This can improve performance and enable you to more closely represent the meaning of equality for the type.

Windows 런타임Windows Runtime에 대 한 참고 사항Notes for the Windows 런타임Windows Runtime

Windows 런타임Windows Runtime 구조체에서 Equals 메서드를 호출 하는 경우 Equals를 재정의 하지 않는 값 형식에 대 한 기본 동작을 제공 합니다.When you call the Equals method on a Windows 런타임Windows Runtime structure, it provides the default behavior for value types that don't override Equals. 이는 .NET Framework에서 Windows 런타임Windows Runtime에 대해 제공 하는 지원의 일부입니다 ( Windows 스토어 앱 및 Windows 런타임에 대 한 .NET Framework 지원참조).This is part of the support that the .NET Framework provides for the Windows 런타임Windows Runtime (see .NET Framework Support for Windows Store Apps and Windows Runtime). Windows 런타임Windows Runtime 구조체는 메서드를 가질 수 없기 때문에 Visual Basic 또는 C# 를 사용 하 여 작성 된 경우에도 Equals를 재정의할 수 없습니다.structures can't override Equals, even if they're written with C# or Visual Basic, because they can't have methods. 또한 Windows 런타임Windows Runtime 자체의 구조체는 ValueType를 상속 하지 않습니다. 그러나 C# 또는 Visual Basic 코드에서 사용 하는 경우 ToString, EqualsGetHashCode 메서드를 사용 하는 것 처럼 보이지만 .NET Framework는 이러한 메서드에 대 한 기본 동작을 제공 합니다.(In addition, structures in the Windows 런타임Windows Runtime itself don't inherit ValueType.) However, they appear to have ToString, Equals, and GetHashCode methods when you use them in your C# or Visual Basic code, and the .NET Framework provides the default behavior for these methods.

Applies to