Object.Equals Metoda

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

Określa, czy dwa wystąpienia obiektu są takie same.

Przeciążenia

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.
Equals(Object, Object)	Określa, czy określone wystąpienia obiektów są traktowane jako równe.

Equals(Object)

Źródło:

Object.cs

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

public:
 virtual bool Equals(System::Object ^ obj);

public virtual bool Equals (object? obj);

abstract member Equals : obj -> bool
override this.Equals : obj -> bool

Public Overridable Function Equals (obj As Object) As Boolean

Parametry

obj

Object

Obiekt do porównania z bieżącym obiektem.

Zwraca

Boolean

Wartość true, jeśli określony obiekt jest taki sam, jak bieżący obiekt, w przeciwnym razie wartość false.

Uwagi

Aby uzyskać więcej informacji na temat tego interfejsu API, zobacz dodatkowe uwagi dotyczące interfejsu API dla obiektu Object.Equals.

Zobacz też

• ReferenceEquals(Object, Object)
• GetHashCode()
• ValueType
• IComparable
• ArrayList
• Hashtable

Equals(Object, Object)

Źródło:

Object.cs

Określa, czy określone wystąpienia obiektów są traktowane jako równe.

public:
 static bool Equals(System::Object ^ objA, System::Object ^ objB);

public static bool Equals (object? objA, object? objB);

static member Equals : obj * obj -> bool

Public Shared Function Equals (objA As Object, objB As Object) As Boolean

Parametry

objA

Object

Pierwszy obiekt do porównania.

objB

Object

Drugi obiekt do porównania.

Zwraca

Boolean

true jeśli obiekty są uważane za równe; w przeciwnym razie , false. Jeśli obie objA wartości i objB mają wartość null, metoda zwraca wartość true.

Przykłady

Poniższy przykład ilustruje metodę Equals(Object, Object) i porównuje ją z ReferenceEquals metodą .

using System;

public class Example
{
   public static void Main()
   {
      Dog m1 = new Dog("Alaskan Malamute");
      Dog m2 = new Dog("Alaskan Malamute");
      Dog g1 = new Dog("Great Pyrenees");
      Dog g2 = g1;
      Dog d1 = new Dog("Dalmation");
      Dog n1 = null;
      Dog n2 = null;

      Console.WriteLine("null = null: {0}", Object.Equals(n1, n2));
      Console.WriteLine("null Reference Equals null: {0}\n", Object.ReferenceEquals(n1, n2));

      Console.WriteLine("{0} = {1}: {2}", g1, g2, Object.Equals(g1, g2));
      Console.WriteLine("{0} Reference Equals {1}: {2}\n", g1, g2, Object.ReferenceEquals(g1, g2));

      Console.WriteLine("{0} = {1}: {2}", m1, m2, Object.Equals(m1, m2));
      Console.WriteLine("{0} Reference Equals {1}: {2}\n", m1, m2, Object.ReferenceEquals(m1, m2));

      Console.WriteLine("{0} = {1}: {2}", m1, d1, Object.Equals(m1, d1));
      Console.WriteLine("{0} Reference Equals {1}: {2}", m1, d1, Object.ReferenceEquals(m1, d1));
   }
}

public class Dog
{
   // Public field.
   public string Breed;

   // Class constructor.
   public Dog(string dogBreed)
   {
      this.Breed = dogBreed;
   }

   public override bool Equals(Object obj)
   {
      if (obj == null || !(obj is Dog))
         return false;
      else
         return this.Breed == ((Dog) obj).Breed;
   }

   public override int GetHashCode()
   {
      return this.Breed.GetHashCode();
   }

   public override string ToString()
   {
      return this.Breed;
   }
}
// The example displays the following output:
//       null = null: True
//       null Reference Equals null: True
//
//       Great Pyrenees = Great Pyrenees: True
//       Great Pyrenees Reference Equals Great Pyrenees: True
//
//       Alaskan Malamute = Alaskan Malamute: True
//       Alaskan Malamute Reference Equals Alaskan Malamute: False
//
//       Alaskan Malamute = Dalmation: False
//       Alaskan Malamute Reference Equals Dalmation: False

open System

// Class constructor
type Dog(dogBreed) =
    // Public property.
    member _.Breed = dogBreed

    override this.Equals(obj) =
        match obj with
        | :? Dog as dog when dog.Breed = this.Breed -> true
        | _ -> false

    override _.GetHashCode() =
        dogBreed.GetHashCode()

    override _.ToString() =
        dogBreed

let m1 = Dog "Alaskan Malamute"
let m2 = Dog "Alaskan Malamute"
let g1 = Dog "Great Pyrenees"
let g2 = g1
let d1 = Dog "Dalmation"
let n1 = Unchecked.defaultof<Dog>
let n2 = Unchecked.defaultof<Dog>

printfn $"null = null: {Object.Equals(n1, n2)}"
printfn $"null Reference Equals null: {Object.ReferenceEquals(n1, n2)}\n"

printfn $"{g1} = {g2}: {Object.Equals(g1, g2)}"
printfn $"{g1} Reference Equals {g2}: {Object.ReferenceEquals(g1, g2)}\n"

printfn $"{m1} = {m2}: {Object.Equals(m1, m2)}"
printfn $"{m1} Reference Equals {m2}: {Object.ReferenceEquals(m1, m2)}\n"

printfn $"{m1} = {d1}: {Object.Equals(m1, d1)}"
printfn $"{m1} Reference Equals {d1}: {Object.ReferenceEquals(m1, d1)}"

// The example displays the following output:
//       null = null: True
//       null Reference Equals null: True
//
//       Great Pyrenees = Great Pyrenees: True
//       Great Pyrenees Reference Equals Great Pyrenees: True
//
//       Alaskan Malamute = Alaskan Malamute: True
//       Alaskan Malamute Reference Equals Alaskan Malamute: False
//
//       Alaskan Malamute = Dalmation: False
//       Alaskan Malamute Reference Equals Dalmation: False

Module Example
   Public Sub Main()
      Dim m1 As New Dog("Alaskan Malamute")
      Dim m2 As New Dog("Alaskan Malamute")
      Dim g1 As New Dog("Great Pyrenees")
      Dim g2 As Dog = g1
      Dim d1 As New Dog("Dalmation")
      Dim n1 As Dog = Nothing
      Dim n2 As Dog = Nothing
      
      Console.WriteLine("null = null: {0}", Object.Equals(n1, n2))
      Console.WriteLine("null Reference Equals null: {0}", Object.ReferenceEquals(n1, n2))
      Console.WriteLine()
      
      Console.WriteLine("{0} = {1}: {2}", g1, g2, Object.Equals(g1, g2))
      Console.WriteLine("{0} Reference Equals {1}: {2}", g1, g2, Object.ReferenceEquals(g1, g2))
      Console.WriteLine()
      
      Console.WriteLine("{0} = {1}: {2}", m1, m2, Object.Equals(m1, m2))
      Console.WriteLine("{0} Reference Equals {1}: {2}", m1, m2, Object.ReferenceEquals(m1, m2))
      Console.WriteLine()
      
      Console.WriteLine("{0} = {1}: {2}", m1, d1, Object.Equals(m1, d1))  
      Console.WriteLine("{0} Reference Equals {1}: {2}", m1, d1, Object.ReferenceEquals(m1, d1))  
   End Sub
End Module

Public Class Dog
   ' Public field.
   Public Breed As String
   
   ' Class constructor.
   Public Sub New(dogBreed As String)
      Me.Breed = dogBreed
   End Sub

   Public Overrides Function Equals(obj As Object) As Boolean
      If obj Is Nothing OrElse Not typeof obj Is Dog Then
         Return False
      Else
         Return Me.Breed = CType(obj, Dog).Breed
      End If   
   End Function
   
   Public Overrides Function GetHashCode() As Integer
      Return Me.Breed.GetHashCode()
   End Function
   
   Public Overrides Function ToString() As String
      Return Me.Breed
   End Function
End Class
' The example displays the following output:
'       null = null: True
'       null Reference Equals null: True
'       
'       Great Pyrenees = Great Pyrenees: True
'       Great Pyrenees Reference Equals Great Pyrenees: True
'       
'       Alaskan Malamute = Alaskan Malamute: True
'       Alaskan Malamute Reference Equals Alaskan Malamute: False
'       
'       Alaskan Malamute = Dalmation: False
'       Alaskan Malamute Reference Equals Dalmation: False

Uwagi

Metoda statyczna Equals(Object, Object) wskazuje, czy dwa obiekty i objAobjB, są równe. Umożliwia również testowanie obiektów, których wartość ma wartość null dla równości. Porównuje objAobjB i pod kątem równości w następujący sposób:

• Określa, czy dwa obiekty reprezentują to samo odwołanie do obiektu. Jeśli tak, metoda zwraca truewartość . Ten test jest odpowiednikiem wywoływania ReferenceEquals metody . Ponadto, jeśli obie objA wartości i objB mają wartość null, metoda zwraca truewartość .

• Określa, czy ma wartość objA null, czy objB też ma wartość null. Jeśli tak, zwraca wartość false.

• Jeśli dwa obiekty nie reprezentują tego samego odwołania do obiektu i żadna z nich nie ma wartości null, wywołuje metodę objA.Equals(objB) i zwraca wynik. Oznacza to, że jeśli objA zastąpi metodę Object.Equals(Object) , to zastąpienie jest wywoływane.

Zobacz też

• Equals(Object)
• ReferenceEquals(Object, Object)