ValueType.Equals(Object) Metode

Definisi

Ruang nama:

System

Rakitan:

System.Runtime.dll

Sumber:

ValueType.cs

Menunjukkan apakah instans ini dan objek tertentu sama.

public:
 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

Parameter

obj

Object

Objek untuk dibandingkan dengan instans saat ini.

Mengembalikan

Boolean

true jika obj dan instans ini adalah jenis yang sama dan mewakili nilai yang sama; jika tidak, false.

Contoh

Contoh berikut menunjukkan bagaimana metode Equals dapat ditimpa oleh jenis nilai turunan.

public ref struct Complex
{
public:
   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;
      }
      else
      {
         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();
    }
}

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

Keterangan

Metode ValueType.Equals(Object) mengambil alih Object.Equals(Object) dan menyediakan implementasi default kesetaraan nilai untuk semua jenis nilai di .NET.

Implementasi default memanggil Object.Equals(Object) pada setiap bidang instans saat ini dan obj dan mengembalikan true jika semua bidang sama.

.NET 9 dan yang lebih baru, implementasi default ValueType.Equals(Object) melemparkan NotSupportedException jika InlineArrayAttribute diterapkan ke jenis .

Penting

Terutama jika jenis nilai Anda berisi bidang yang merupakan jenis referensi, Anda harus mengambil alih metode Equals(Object). Ini dapat meningkatkan performa dan memungkinkan Anda untuk lebih mewakili arti kesetaraan untuk jenis tersebut.

Catatan untuk Windows Runtime

Saat Anda memanggil metode Equals pada struktur Windows Runtime, metode ini menyediakan perilaku default untuk jenis nilai yang tidak mengambil alih Equals. Ini adalah bagian dari dukungan yang disediakan .NET untuk Windows Runtime (lihat dukungan .NET untuk Aplikasi Windows Store dan Windows Runtime). Struktur Windows Runtime tidak dapat mengambil alih Equals, meskipun ditulis dengan C# atau Visual Basic, karena tidak dapat memiliki metode. (Selain itu, struktur dalam Windows Runtime itu sendiri tidak mewarisi ValueType.) Namun, mereka tampaknya memiliki metode ToString, Equals, dan GetHashCode saat Anda menggunakannya dalam kode C# atau Visual Basic Anda, dan .NET menyediakan perilaku default untuk metode ini.