Int32.Equals Метод

Определение

Пространство имен:

System

Сборка:

System.Runtime.dll

Возвращает значение, указывающее, равен ли этот экземпляр заданному значению типа Int32.

Перегрузки

Equals(Int32)	Возвращает значение, указывающее, равен ли этот экземпляр заданному значению типа Int32.
Equals(Object)	Возвращает значение, показывающее, равен ли данный экземпляр заданному объекту.

Equals(Int32)

Исходный код:

Int32.cs

Возвращает значение, указывающее, равен ли этот экземпляр заданному значению типа Int32.

C#

public bool Equals (int obj);

Параметры

obj

Int32

Значение типа Int32 для сравнения с данным экземпляром.

Возвращаемое значение

Boolean

true, если значение параметра obj совпадает со значением данного экземпляра; в противном случае — false.

Реализации

Equals(T)

Комментарии

Этот метод реализует System.IEquatable<T> интерфейс и работает немного лучше, чем Int32.Equals(Object) потому, что ему не нужно преобразовывать obj параметр в объект .

Примечания для тех, кто вызывает этот метод

Разрешение перегрузки компилятора может учесть очевидное различие в поведении перегрузок двух Equals(Int32) методов. Если определено неявное преобразование между obj аргументом и и Int32 аргумент не типизуется как Object, компиляторы выполняют неявное преобразование и вызывают Equals(Int32) метод . В противном случае они вызывают Equals(Object) метод , который всегда возвращает false , если его obj аргумент не является значением Int32 . В следующем примере показана разница в поведении двух перегрузок методов. В случае Byteсо значениями , Int16, SByteи UInt16 первое сравнение возвращается true , так как компилятор автоматически выполняет расширяющее преобразование и вызывает Equals(Int32) метод , а второе — false потому, что компилятор вызывает Equals(Object) метод .

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)

Исходный код:

Int32.cs

Возвращает значение, показывающее, равен ли данный экземпляр заданному объекту.

C#

public override bool Equals (object? obj);

Параметры

obj

Object

Объект для сравнения с данным экземпляром.

Возвращаемое значение

Boolean

Значение true, если параметр obj является экземпляром типа Int32 и равен значению данного экземпляра; в противном случае — значение false.

Примеры

В следующем примере показано использование Equals в контексте Int32, сравнивая два int значения и возвращая true , если они представляют одно и то же число, или false если они не представляют.

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");

Примечания для тех, кто вызывает этот метод

Разрешение перегрузки компилятора может учесть очевидное различие в поведении перегрузок двух Equals(Int32) методов. Если определено неявное преобразование между obj аргументом и и Int32 аргумент не типизуется как Object, компиляторы выполняют неявное преобразование и вызывают Equals(Int32) метод . В противном случае они вызывают Equals(Object) метод , который всегда возвращает false , если его obj аргумент не является значением Int32 . В следующем примере показана разница в поведении двух перегрузок методов. В случае Byteсо значениями , Int16, SByteи UInt16 первое сравнение возвращается true , так как компилятор автоматически выполняет расширяющее преобразование и вызывает Equals(Int32) метод , а второе — false потому, что компилятор вызывает Equals(Object) метод .

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

См. также раздел

• CompareTo(Object)