Int32.Equals Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает значение, указывающее, равен ли этот экземпляр заданному значению типа Int32.
Перегрузки
Equals(Int32) |
Возвращает значение, указывающее, равен ли этот экземпляр заданному значению типа Int32. |
Equals(Object) |
Возвращает значение, показывающее, равен ли данный экземпляр заданному объекту. |
Equals(Int32)
Возвращает значение, указывающее, равен ли этот экземпляр заданному значению типа Int32.
public:
virtual bool Equals(int obj);
public bool Equals (int obj);
override this.Equals : int -> bool
Public Function Equals (obj As Integer) As Boolean
Параметры
Возвращаемое значение
true
, если значение параметра obj
совпадает со значением данного экземпляра; в противном случае — false
.
Реализации
Комментарии
Этот метод реализует System.IEquatable<T> интерфейс и выполняет немного лучше, чем Int32.Equals(Object) потому, что ему не нужно преобразовывать obj
параметр в объект.
Примечания для тех, кто вызывает этот метод
Разрешение перегрузки компилятора может учитывать очевидное различие в поведении двух Equals(Int32) перегрузок методов. Если неявное преобразование между obj
аргументом и аргументом Int32 не Objectзадано, компиляторы выполняют неявное преобразование и вызывают Equals(Int32) метод. В противном случае они вызывают Equals(Object) метод, который всегда возвращается false
, если его obj
аргумент не является значением Int32 . В следующем примере показано различие в поведении между двумя перегрузками методов. В случае Byteс , , SByteInt16и UInt16 значениями, первое сравнение возвращается, поскольку компилятор автоматически выполняет расширение преобразования и вызывает Equals(Int32) метод, тогда как второе сравнение возвращается true
false
, так как компилятор вызывает Equals(Object) метод.
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)
Возвращает значение, показывающее, равен ли данный экземпляр заданному объекту.
public:
override bool Equals(System::Object ^ obj);
public override bool Equals (object obj);
public override bool Equals (object? obj);
override this.Equals : obj -> bool
Public Overrides Function Equals (obj As Object) As Boolean
Параметры
- obj
- Object
Объект для сравнения с данным экземпляром.
Возвращаемое значение
Значение true
, если параметр obj
является экземпляром типа Int32 и равен значению данного экземпляра; в противном случае — значение false
.
Примеры
В следующем примере показано использование Equals
в контексте, сравнение двух int
значений Int32
и возвратtrue
, если они представляют одно и то же число или false
нет.
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" );
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");
let myVariable1 = 60
let myVariable2 = 60
// Get and display the declaring type.
printfn $"\nType of 'myVariable1' is '{myVariable1.GetType()}' and value is: {myVariable1}"
printfn $"Type of 'myVariable2' is '{myVariable2.GetType()}' and value is: {myVariable2}"
// Compare 'myVariable1' instance with 'myVariable2' Object.
if myVariable1.Equals myVariable2 then
printfn "\nStructures 'myVariable1' and 'myVariable2' are equal"
else
printfn "\nStructures 'myVariable1' and 'myVariable2' are not equal"
Dim myVariable1 As Int32 = 60
Dim myVariable2 As Int32 = 60
' Get and display the declaring type.
Console.WriteLine(ControlChars.NewLine + "Type of 'myVariable1' is '{0}' and" + _
" value is :{1}", myVariable1.GetType().ToString(), myVariable1.ToString())
Console.WriteLine("Type of 'myVariable2' is '{0}' and" + _
" value is :{1}", myVariable2.GetType().ToString(), myVariable2.ToString())
' Compare 'myVariable1' instance with 'myVariable2' Object.
If myVariable1.Equals(myVariable2) Then
Console.WriteLine(ControlChars.NewLine + "Structures 'myVariable1' and " + _
"'myVariable2' are equal")
Else
Console.WriteLine(ControlChars.NewLine + "Structures 'myVariable1' and " + _
"'myVariable2' are not equal")
End If
Примечания для тех, кто вызывает этот метод
Разрешение перегрузки компилятора может учитывать очевидное различие в поведении двух Equals(Int32) перегрузок методов. Если неявное преобразование между obj
аргументом и аргументом Int32 не Objectзадано, компиляторы выполняют неявное преобразование и вызывают Equals(Int32) метод. В противном случае они вызывают Equals(Object) метод, который всегда возвращается false
, если его obj
аргумент не является значением Int32 . В следующем примере показано различие в поведении между двумя перегрузками методов. В случае Byteс , , SByteInt16и UInt16 значениями, первое сравнение возвращается, поскольку компилятор автоматически выполняет расширение преобразования и вызывает Equals(Int32) метод, тогда как второе сравнение возвращается true
false
, так как компилятор вызывает Equals(Object) метод.
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