ValueType.Equals(Object) ValueType.Equals(Object) ValueType.Equals(Object) 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


Object Object Object Object

現在のインスタンスと比較するオブジェクト。The object to compare with the current instance.


true とこのインスタンスが同じ型で、同じ値を表している場合は obj。それ以外の場合は falsetrue 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参照型の場合は、Equalsメソッドは、メモリ内で 2 つのオブジェクトのバイトで比較を実行します。If none of the fields of the current instance and obj are reference types, the Equals method performs a byte-by-byte comparison of the two objects in memory. 対応するフィールドを比較する、リフレクションを使用して、それ以外の場合、objとこのインスタンス。Otherwise, it uses reflection to compare the corresponding fields of obj and this instance.


オーバーライドする必要がありますが、値型に参照型であるフィールドが含まれている場合は特に、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 RuntimeNotes for the Windows ランタイムWindows Runtime

呼び出すと、EqualsメソッドをWindows ランタイムWindows Runtime構造をオーバーライドしない値の型の既定の動作を提供、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 ストア アプリ用 .NET と Windows ランタイム)。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 構造体をオーバーライドできませんEqualsで書かれている場合でも、C#または Visual Basic の場合は、メソッドを含めることはできませんので。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)。ただし、あるように見えますToStringEqualsGetHashCodeメソッド、C# または Visual Basic のコードで使用すると、.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.