C#のGetEnumValues()メソッドで列挙型の定数値の配列を取得する方法

C#では、Type.GetEnumValues()メソッドを使用することで、現在の列挙型（enum）に含まれる定数の値の配列を取得できます。この記事では、実際のコード例を通じて、その使い方と動作をわかりやすく解説します。

GetEnumValues()メソッドとは

GetEnumValues()は、指定した型が列挙型である場合に、その定数値を格納した配列（Array）を返すメソッドです。ただし、対象の型が列挙型ではない場合にはArgumentException例外がスローされるため、注意が必要です。

例1：列挙型以外の型を指定した場合

まず、列挙型ではないint型に対してこのメソッドを呼び出した場合の動作を見てみましょう。

using System;
public class Demo {
    enum Vehicle {Car, Bus, Bike, Airplane}
    public static void Main() {
        try {
            Type type = typeof(int);
            string[] str = type.GetEnumNames();
            Console.WriteLine("GetEnumNames() to return the constant name = " + str);
            Type type2 = type.GetEnumUnderlyingType();
            Console.Write("Enum Underlying type = "+type2);
            Array arrObj = type.GetEnumValues();
            Console.Write("Values = {0}"+arrObj);
            Console.WriteLine("\nListing constants ..");
            for (int i = 0; i < str.Length; i++)
                Console.Write("{0} ", str[i]);
        }
        catch (ArgumentException e) {
            Console.WriteLine("Not an enum!");
            Console.Write("{0}", e.GetType(), e.Message);
        }
    }
}

実行結果

Not an enum!
System.ArgumentException

int型は列挙型ではないため、ArgumentException例外が発生し、catchブロック内の「Not an enum!」というメッセージが出力されます。

例2：正しい列挙型を指定した場合

次に、独自に定義したVehicle列挙型に対してメソッドを呼び出した場合の例です。

using System;
public class Demo {
    enum Vehicle {Car, Bus, Bike, Airplane}
    public static void Main() {
        try {
            Vehicle v = Vehicle.Bike;
            Type type = v.GetType();
            string[] str = type.GetEnumNames();
            Console.WriteLine("GetEnumName() to return the constant name = " + str);
            Type type2 = type.GetEnumUnderlyingType();
            Console.Write("Enum Underlying type = "+type2);
            Array arrObj = type.GetEnumValues();
            Console.Write("Values = "+arrObj);
            Console.WriteLine("\nListing constants ..");
            for (int i = 0; i < str.Length; i++)
                Console.Write("{0} ", str[i]);
        }
        catch (ArgumentException e) {
            Console.WriteLine("Not an enum!");
            Console.Write("{0}", e.GetType(), e.Message);
        }
    }
}

実行結果

GetEnumName() to return the constant name = System.String[]
Enum Underlying type = System.Int32Values = Demo+Vehicle[]
Listing constants ..
Car Bus Bike Airplane

コードのポイント解説

• GetEnumNames()：列挙型に含まれる定数名を文字列配列（string[]）として返します。
• GetEnumUnderlyingType()：列挙型の基になる型を返します。明示的に指定しない限り、C#の列挙型は既定でSystem.Int32（int型）を基盤とします。
• GetEnumValues()：列挙型のすべての定数値を格納した配列を返します。今回の例ではDemo+Vehicle[]型の配列が取得されています。

このように、まずGetType()メソッドで列挙値から型情報を取得し、その型オブジェクトに対してGetEnumValues()を呼び出すことで、列挙型の定数値の配列を簡単に取得できます。列挙型以外の型を渡した場合は例外がスローされるため、try-catchによる適切な例外処理を組み合わせると安全です。