Int32.Equals Método

Definição

Retorna um valor que indica se a instância é igual a um valor Int32 especificado.Returns a value indicating whether this instance is equal to a specified Int32 value.

Sobrecargas

Equals(Int32)

Retorna um valor que indica se a instância é igual a um valor Int32 especificado.Returns a value indicating whether this instance is equal to a specified Int32 value.

Equals(Object)

Retorna um valor que indica se a instância é igual a um objeto especificado.Returns a value indicating whether this instance is equal to a specified object.

Equals(Int32)

Retorna um valor que indica se a instância é igual a um valor Int32 especificado.Returns a value indicating whether this instance is equal to a specified Int32 value.

public:
 virtual bool Equals(int obj);
public bool Equals (int obj);
override this.Equals : int -> bool
Public Function Equals (obj As Integer) As Boolean

Parâmetros

obj
Int32

Um valor Int32 a ser comparado com a instância.An Int32 value to compare to this instance.

Retornos

Boolean

true caso obj tenha o mesmo valor da instância; caso contrário, false.true if obj has the same value as this instance; otherwise, false.

Implementações

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.This method implements the System.IEquatable<T> interface, and performs slightly better than Int32.Equals(Object) because it does not have to convert the obj parameter to an object.

Notas aos Chamadores

A resolução de sobrecarga do compilador pode considerar uma diferença aparente no comportamento das duas Equals(Int32) sobrecargas de método.Compiler overload resolution may account for an apparent difference in the behavior of the two Equals(Int32) method overloads. 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.If an implicit conversion between the obj argument and an Int32 is defined and the argument is not typed as an Object, compilers perform an implicit conversion and call the Equals(Int32) method. Caso contrário, eles chamarão o Equals(Object) método, que sempre retorna false se o obj argumento não for um Int32 valor.Otherwise, they call the Equals(Object) method, which always returns false if its obj argument is not an Int32 value. O exemplo a seguir ilustra a diferença no comportamento entre as duas sobrecargas de método.The following example illustrates the difference in behavior between the two method overloads. No caso dos Byte valores,, Int16 SByte e UInt16 , 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.In the case of the Byte, Int16, SByte, and UInt16 values, the first comparison returns true because the compiler automatically performs a widening conversion and calls the Equals(Int32) method, whereas the second comparison returns false because the compiler calls the Equals(Object) method.

::: código Language = "CSharp" origem = "~/Samples/Snippets/Csharp/VS_Snippets_CLR_System/System.Int32.Equals/cs/equalsoverloads2.cs" Interactive = "try-dotnet" ID = "Snippet1":::::: código Language = "vb" origem = "~/Samples/Snippets/VisualBasic/VS_Snippets_CLR_System/System.Int32.Equals/VB/equalsoverloads2.vb" ID = "Snippet1"::::::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.int32.equals/cs/equalsoverloads2.cs" interactive="try-dotnet" id="Snippet1"::: :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.int32.equals/vb/equalsoverloads2.vb" id="Snippet1":::

Aplica-se a

Equals(Object)

Retorna um valor que indica se a instância é igual a um objeto especificado.Returns a value indicating whether this instance is equal to a specified object.

public:
 override bool Equals(System::Object ^ obj);
public override bool Equals (object obj);
override this.Equals : obj -> bool
Public Overrides Function Equals (obj As Object) As Boolean

Parâmetros

obj
Object

Um objeto a ser comparado com essa instância.An object to compare with this instance.

Retornos

Boolean

true se obj é uma instância de Int32 e é igual ao valor dessa instância; caso contrário, false.true if obj is an instance of Int32 and equals the value of this instance; otherwise, false.

Exemplos

O exemplo a seguir ilustra o uso de Equals no contexto de Int32 , comparando dois int valores e retornando true se eles representam o mesmo número, ou false se não tiverem.The following example illustrates the use of Equals in the context of Int32, comparing two int values and returning true if they represent the same number, or false if they do not.

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

Notas aos Chamadores

A resolução de sobrecarga do compilador pode considerar uma diferença aparente no comportamento das duas Equals(Int32) sobrecargas de método.Compiler overload resolution may account for an apparent difference in the behavior of the two Equals(Int32) method overloads. 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.If an implicit conversion between the obj argument and an Int32 is defined and the argument is not typed as an Object, compilers perform an implicit conversion and call the Equals(Int32) method. Caso contrário, eles chamarão o Equals(Object) método, que sempre retorna false se o obj argumento não for um Int32 valor.Otherwise, they call the Equals(Object) method, which always returns false if its obj argument is not an Int32 value. O exemplo a seguir ilustra a diferença no comportamento entre as duas sobrecargas de método.The following example illustrates the difference in behavior between the two method overloads. No caso dos Byte valores,, Int16 SByte e UInt16 , 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.In the case of the Byte, Int16, SByte, and UInt16 values, the first comparison returns true because the compiler automatically performs a widening conversion and calls the Equals(Int32) method, whereas the second comparison returns false because the compiler calls the Equals(Object) method.

::: código Language = "CSharp" origem = "~/Samples/Snippets/Csharp/VS_Snippets_CLR_System/System.Int32.Equals/cs/equalsoverloads2.cs" Interactive = "try-dotnet" ID = "Snippet1":::::: código Language = "vb" origem = "~/Samples/Snippets/VisualBasic/VS_Snippets_CLR_System/System.Int32.Equals/VB/equalsoverloads2.vb" ID = "Snippet1"::::::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.int32.equals/cs/equalsoverloads2.cs" interactive="try-dotnet" id="Snippet1"::: :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.int32.equals/vb/equalsoverloads2.vb" id="Snippet1":::

Confira também

Aplica-se a