UInt16::Equals Method (Object^)

.NET Framework (current version)

Returns a value indicating whether this instance is equal to a specified object.

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

Syntax

public:
virtual bool Equals(
	Object^ obj
) override

Parameters

obj: Type: System::Object^
An object to compare to this instance.

Return Value

Type: System::Boolean

true if obj is an instance of UInt16 and equals the value of this instance; otherwise, false.

Notes to Callers:

Compiler overload resolution may account for an apparent difference in the behavior of the two Equals method overloads. If an implicit conversion between the obj argument and a UInt16 is defined and the argument is not typed as an Object, compilers perform an implicit conversion and call the Equals(UInt16) method. Otherwise, they call the Equals(Object^) method, which always returns false if its obj argument is not a UInt16 value. The following example illustrates the difference in behavior between the two method overloads. In the case of a Byte value, the first comparison returns true because the compiler automatically performs a widening conversion and calls the Equals(UInt16) method, whereas the second comparison returns false because the compiler calls the Equals(Object^) method.

C++

No code example is currently available or this language may not be supported.

Examples

The following example demonstrates the Equals method.

C++

UInt16 myVariable1 = 10;
UInt16 myVariable2 = 10;

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

Version Information

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1