Export (0) Print
Expand All
0 out of 1 rated this helpful - Rate this topic

Enum::CompareTo Method

Compares this instance to a specified object and returns an indication of their relative values.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)
virtual int CompareTo(
	Object^ target
) sealed


Type: System::Object
An object to compare, or nullptr.

Return Value

Type: System::Int32
A signed number that indicates the relative values of this instance and target.



Less than zero

The value of this instance is less than the value of target.


The value of this instance is equal to the value of target.

Greater than zero

The value of this instance is greater than the value of target.


target is nullptr.



target and this instance are not the same type.


This instance is not type SByte, Int16, Int32, Int64, Byte, UInt16, UInt32, or UInt64.


This instance is nullptr.

The following example illustrates the use of CompareTo in the context of Enum.

using namespace System;
enum class VehicleDoors
   Motorbike = 0,
   Sportscar = 2,
   Sedan = 4,
   Hatchback = 5

int main()
   VehicleDoors myVeh = VehicleDoors::Sportscar;
   VehicleDoors yourVeh = VehicleDoors::Motorbike;
   VehicleDoors otherVeh = VehicleDoors::Sedan;
   Console::WriteLine(  "Does a {0} have more doors than a {1}?", myVeh, yourVeh );
   Int32 iRes = myVeh.CompareTo( yourVeh );
   Console::WriteLine(  "{0}{1}", iRes > 0 ? (String^)"Yes" : "No", Environment::NewLine );
   Console::WriteLine(  "Does a {0} have more doors than a {1}?", myVeh, otherVeh );
   iRes = myVeh.CompareTo( otherVeh );
   Console::WriteLine(  "{0}", iRes > 0 ? (String^)"Yes" : "No" );
// The example displays the following output:
//       Does a Sportscar have more doors than a Motorbike?
//       Yes
//       Does a Sportscar have more doors than a Sedan?
//       No

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

© 2014 Microsoft. All rights reserved.