Int32.Equals Método

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Retorna um valor que indica se a instância é igual a um valor Int32 especificado.

Sobrecargas

Equals(Int32)	Retorna um valor que indica se a instância é igual a um valor Int32 especificado.
Equals(Object)	Retorna um valor que indica se a instância é igual a um objeto especificado.

Equals(Int32)

Retorna um valor que indica se a instância é igual a um valor Int32 especificado.

C#

public bool Equals (int obj);

Parâmetros

obj

Int32

Um valor Int32 a ser comparado com a instância.

Retornos

Boolean

true caso obj tenha o mesmo valor da instância; caso contrário, false.

Implementações

Equals(T)

Comentários

Esse método implementa a System.IEquatable<T> interface e executa um pouco melhor do que Int32.Equals(Object) porque não precisa converter o obj parâmetro em um objeto.

Notas aos Chamadores

A resolução de sobrecarga do compilador pode levar em conta uma diferença aparente no comportamento das duas Equals(Int32) sobrecargas de método. Se uma conversão implícita entre o obj argumento e um Int32 for definida e o argumento não for digitado como um Object, os compiladores executarão uma conversão implícita e chamarão o Equals(Int32) método. Caso contrário, eles chamam o Equals(Object) método, que sempre retorna false se seu obj argumento não for um Int32 valor. O exemplo a seguir ilustra a diferença de comportamento entre as sobrecargas de dois métodos. No caso de Byte, , Int16SBytee UInt16 valores, a primeira comparação retorna true porque o compilador executa automaticamente uma conversão de ampliação e chama o Equals(Int32) método, enquanto a segunda comparação retorna false porque o compilador chama o Equals(Object) método.

C#

using System;

public class Example
{
   static int value = 112;

   public static void Main()
   {
      byte byte1= 112;
      Console.WriteLine("value = byte1: {0,15}", value.Equals(byte1));
      TestObjectForEquality(byte1);

      short short1 = 112;
      Console.WriteLine("value = short1: {0,15}", value.Equals(short1));
      TestObjectForEquality(short1);

      long long1 = 112;
      Console.WriteLine("value = long1: {0,17}", value.Equals(long1));
      TestObjectForEquality(long1);

      sbyte sbyte1 = 112;
      Console.WriteLine("value = sbyte1: {0,15}", value.Equals(sbyte1));
      TestObjectForEquality(sbyte1);

      ushort ushort1 = 112;
      Console.WriteLine("value = ushort1: {0,15}", value.Equals(ushort1));
      TestObjectForEquality(ushort1);

      ulong ulong1 = 112;
      Console.WriteLine("value = ulong1: {0,17}", value.Equals(ulong1));
      TestObjectForEquality(ulong1);

      decimal dec1 = 112m;
      Console.WriteLine("value = dec1: {0,20}", value.Equals(dec1));
      TestObjectForEquality(dec1);

      double dbl1 = 112;
      Console.WriteLine("value = dbl1: {0,19}", value.Equals(dbl1));
      TestObjectForEquality(dbl1);
   }

   private static void TestObjectForEquality(Object obj)
   {
      Console.WriteLine("{0} ({1}) = {2} ({3}): {4}\n",
                        value, value.GetType().Name,
                        obj, obj.GetType().Name,
                        value.Equals(obj));
   }
}
// The example displays the following output:
//       value = byte1:            True
//       112 (Int32) = 112 (Byte): False
//
//       value = short1:            True
//       112 (Int32) = 112 (Int16): False
//
//       value = long1:             False
//       112 (Int32) = 112 (Int64): False
//
//       value = sbyte1:            True
//       112 (Int32) = 112 (SByte): False
//
//       value = ushort1:            True
//       112 (Int32) = 112 (UInt16): False
//
//       value = ulong1:             False
//       112 (Int32) = 112 (UInt64): False
//
//       value = dec1:                False
//       112 (Int32) = 112 (Decimal): False
//
//       value = dbl1:               False
//       112 (Int32) = 112 (Double): False

Equals(Object)

Retorna um valor que indica se a instância é igual a um objeto especificado.

C#

public override bool Equals (object obj);

C#

public override bool Equals (object? obj);

Parâmetros

obj

Object

Um objeto a ser comparado com essa instância.

Retornos

Boolean

true se obj é uma instância de Int32 e é igual ao valor dessa instância; caso contrário, false.

Exemplos

O exemplo a seguir ilustra o uso no Equals contexto de Int32, comparando dois int valores e retornando true se eles representam o mesmo número ou false se não o fizerem.

C#

Int32 myVariable1 = 60;
Int32 myVariable2 = 60;

// Get and display the declaring type.
Console.WriteLine("\nType of 'myVariable1' is '{0}' and"+
     " value is :{1}",myVariable1.GetType(), myVariable1);
Console.WriteLine("Type of 'myVariable2' is '{0}' and"+
     " value is :{1}",myVariable2.GetType(), myVariable2);

// Compare 'myVariable1' instance with 'myVariable2' Object.
if( myVariable1.Equals( myVariable2 ) )
   Console.WriteLine( "\nStructures 'myVariable1' and "+
         "'myVariable2' are equal");
else
   Console.WriteLine( "\nStructures 'myVariable1' and "+
         "'myVariable2' are not equal");

Notas aos Chamadores

A resolução de sobrecarga do compilador pode levar em conta uma diferença aparente no comportamento das duas Equals(Int32) sobrecargas de método. Se uma conversão implícita entre o obj argumento e um Int32 for definida e o argumento não for digitado como um Object, os compiladores executarão uma conversão implícita e chamarão o Equals(Int32) método. Caso contrário, eles chamam o Equals(Object) método, que sempre retorna false se seu obj argumento não for um Int32 valor. O exemplo a seguir ilustra a diferença de comportamento entre as sobrecargas de dois métodos. No caso de Byte, , Int16SBytee UInt16 valores, a primeira comparação retorna true porque o compilador executa automaticamente uma conversão de ampliação e chama o Equals(Int32) método, enquanto a segunda comparação retorna false porque o compilador chama o Equals(Object) método.

C#

using System;

public class Example
{
   static int value = 112;

   public static void Main()
   {
      byte byte1= 112;
      Console.WriteLine("value = byte1: {0,15}", value.Equals(byte1));
      TestObjectForEquality(byte1);

      short short1 = 112;
      Console.WriteLine("value = short1: {0,15}", value.Equals(short1));
      TestObjectForEquality(short1);

      long long1 = 112;
      Console.WriteLine("value = long1: {0,17}", value.Equals(long1));
      TestObjectForEquality(long1);

      sbyte sbyte1 = 112;
      Console.WriteLine("value = sbyte1: {0,15}", value.Equals(sbyte1));
      TestObjectForEquality(sbyte1);

      ushort ushort1 = 112;
      Console.WriteLine("value = ushort1: {0,15}", value.Equals(ushort1));
      TestObjectForEquality(ushort1);

      ulong ulong1 = 112;
      Console.WriteLine("value = ulong1: {0,17}", value.Equals(ulong1));
      TestObjectForEquality(ulong1);

      decimal dec1 = 112m;
      Console.WriteLine("value = dec1: {0,20}", value.Equals(dec1));
      TestObjectForEquality(dec1);

      double dbl1 = 112;
      Console.WriteLine("value = dbl1: {0,19}", value.Equals(dbl1));
      TestObjectForEquality(dbl1);
   }

   private static void TestObjectForEquality(Object obj)
   {
      Console.WriteLine("{0} ({1}) = {2} ({3}): {4}\n",
                        value, value.GetType().Name,
                        obj, obj.GetType().Name,
                        value.Equals(obj));
   }
}
// The example displays the following output:
//       value = byte1:            True
//       112 (Int32) = 112 (Byte): False
//
//       value = short1:            True
//       112 (Int32) = 112 (Int16): False
//
//       value = long1:             False
//       112 (Int32) = 112 (Int64): False
//
//       value = sbyte1:            True
//       112 (Int32) = 112 (SByte): False
//
//       value = ushort1:            True
//       112 (Int32) = 112 (UInt16): False
//
//       value = ulong1:             False
//       112 (Int32) = 112 (UInt64): False
//
//       value = dec1:                False
//       112 (Int32) = 112 (Decimal): False
//
//       value = dbl1:               False
//       112 (Int32) = 112 (Double): False

Confira também

• CompareTo(Object)