Enum::GetValues Method (Type^)


Retrieves an array of the values of the constants in a specified enumeration.

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

static Array^ GetValues(
	Type^ enumType


Type: System::Type^

An enumeration type.

Return Value

Type: System::Array^

An array that contains the values of the constants in enumType.

Exception Condition

enumType is null.


enumType is not an Enum.


The method is invoked by reflection in a reflection-only context,


enumType is a type from an assembly loaded in a reflection-only context.

The elements of the array are sorted by the binary values of the enumeration constants (that is, by their unsigned magnitude). The following example displays information about the array returned by the GetValues method for an enumeration that includes a negative value, zero, and a positive value.

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

The GetValues method returns an array that contains a value for each member of the enumType enumeration. If multiple members have the same value, the returned array includes duplicate values. In this case, calling the GetName method with each value in the returned array does not restore the unique names assigned to members that have duplicate values. To retrieve all the names of enumeration members successfully, call the GetNames method.

TheGetValues method cannot be invoked by using reflection in a reflection-only context. Instead, you can retrieve the value of all enumeration members by using the Type::GetFields method to get an array of FieldInfo objects that represent enumeration members and then call the FieldInfo::GetRawConstantValue method on each element of the array. The following example illustrates this technique. It requires that you define the following enumeration in an assembly named Enumerations.dll:

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

The assembly is loaded in a reflection-only context, a Type object that represents the Pets enumeration is instantiated, an array of FieldInfo objects is retrieved, and the field values are displayed to the console.

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

The following example illustrates the use of GetValues.

using namespace System;
enum class Colors
   Red, Green, Blue, Yellow

enum class Styles
   Plaid = 0,
   Striped = 23,
   Tartan = 65,
   Corduroy = 78

int main()
   Console::WriteLine(  "The values of the Colors Enum are:" );
   Array^ a = Enum::GetValues( Colors::typeid );
   for ( Int32 i = 0; i < a->Length; i++ )
      Object^ o = a->GetValue( i );
      Console::WriteLine(  "{0}", Enum::Format( Colors::typeid, o,  "D" ) );
   Console::WriteLine(  "The values of the Styles Enum are:" );
   Array^ b = Enum::GetValues( Styles::typeid );
   for ( Int32 i = 0; i < b->Length; i++ )
      Object^ o = b->GetValue( i );
      Console::WriteLine(  "{0}", Enum::Format( Styles::typeid, o,  "D" ) );

// The example produces the following output:
//       The values of the Colors Enum are:
//       0
//       1
//       2
//       3
//       The values of the Styles Enum are:
//       0
//       23
//       65
//       78

Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Available since 5.0
Windows Phone Silverlight
Available since 8.0
Windows Phone
Available since 8.1
Return to top