Object.Equals Método

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Determina se duas instâncias de objeto são iguais.

Sobrecargas

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual.
Equals(Object, Object)	Determina se as instâncias de objeto especificadas são consideradas iguais.

Equals(Object)

Origem:

Object.cs

Determina se o objeto especificado é igual ao objeto atual.

C#

public virtual bool Equals (object? obj);

Parâmetros

obj

Object

O objeto a ser comparado com o objeto atual.

Retornos

Boolean

true se o objeto especificado for igual ao objeto atual, caso contrário, false.

Comentários

Para obter mais informações sobre essa API, consulte Comentários de API complementares para Object.Equals.

Confira também

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

Equals(Object, Object)

Origem:

Object.cs

Determina se as instâncias de objeto especificadas são consideradas iguais.

C#

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

Parâmetros

objA

Object

O primeiro objeto a ser comparado.

objB

Object

O segundo objeto a ser comparado.

Retornos

Boolean

true se os objetos forem considerados iguais; caso contrário, false. Se objA e objB forem null, o método retornará true.

Exemplos

O exemplo a seguir ilustra o Equals(Object, Object) método e o compara com o ReferenceEquals método .

C#

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

Comentários

O método estático Equals(Object, Object) indica se dois objetos e objAobjB, são iguais. Ele também permite testar objetos cujo valor é nulo para igualdade. Ele compara objA e objB para igualdade da seguinte maneira:

• Ele determina se os dois objetos representam a mesma referência de objeto. Se o fizerem, o método retornará true. Esse teste é equivalente a chamar o ReferenceEquals método . Além disso, se e objAobjB forem nulos, o método retornará true.

• Ele determina se ou objAobjB é nulo. Nesse caso, ele retorna false.

• Se os dois objetos não representarem a mesma referência de objeto e nenhum deles for nulo, ele chamará objA.Equals(objB) e retorna o resultado. Isso significa que, se objA substituir o Object.Equals(Object) método, essa substituição será chamada.

Confira também

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