Enum::GetValues Method
Retrieves an array of the values of the constants in a specified enumeration.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- enumType
- Type: System::Type
The enumeration type to retrieve values from.
| Exception | Condition |
|---|---|
| ArgumentNullException | enumType is nullptr. |
| ArgumentException | enumType is not an Enum. |
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, zero, and positive value.
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.
The following example illustrates how to use 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(); 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
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.