C#のType.GetEnumValues()メソッドとは？使い方をサンプルコード付きで解説

C#のType.GetEnumValues()メソッドは、現在の列挙型（enum）に含まれる定数の値を配列（Array）として返します。この記事では、基本的な構文から実際の使用例まで、サンプルコードを交えながらわかりやすく解説します。

構文

Type.GetEnumValues()メソッドの構文は以下の通りです。

public virtual Array GetEnumValues();

使用例1：列挙型以外の型に呼び出した場合

まず、列挙型ではない型（ここではint型）に対してType.GetEnumValues()メソッドを呼び出した例を見てみましょう。対象が列挙型ではないため、ArgumentExceptionがスローされます。

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()で取得した定数名 = " + str);
            Type type2 = type.GetEnumUnderlyingType();
            Console.Write("列挙型の基になる型 = " + type2);
            Array arrObj = type.GetEnumValues();
            Console.Write("値 = {0}" + arrObj);
            Console.WriteLine("\n定数の一覧を表示します..");
            for (int i = 0; i < str.Length; i++)
                Console.Write("{0} ", str[i]);
        }
        catch (ArgumentException e){
            Console.WriteLine("列挙型ではありません！");
            Console.Write("{0}", e.GetType(), e.Message);
        }
    }
}

出力結果

上記のコードを実行すると、以下のような出力が得られます。

列挙型ではありません！
System.ArgumentException

使用例2：実際の列挙型に呼び出した場合

続いて、正しく列挙型（Vehicle）に対してType.GetEnumValues()メソッドを呼び出した例を見てみましょう。

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()で取得した定数名 = " + str);
            Type type2 = type.GetEnumUnderlyingType();
            Console.Write("列挙型の基になる型 = " + type2);
            Array arrObj = type.GetEnumValues();
            Console.Write("値 = " + arrObj);
            Console.WriteLine("\n定数の一覧を表示します..");
            for (int i = 0; i < str.Length; i++)
                Console.Write("{0} ", str[i]);
        }
        catch (ArgumentException e){
            Console.WriteLine("列挙型ではありません！");
            Console.Write("{0}", e.GetType(), e.Message);
        }
    }
}

出力結果

上記のコードを実行すると、以下のような出力が得られます。

GetEnumName()で取得した定数名 = System.String[]
列挙型の基になる型 = System.Int32値 = Demo+Vehicle[]
定数の一覧を表示します..
Car Bus Bike Airplane

ポイントまとめ

• Type.GetEnumValues()：列挙型のすべての定数値をArrayとして返します。
• Type.GetEnumNames()：列挙型の定数名をstring型の配列として返します。
• Type.GetEnumUnderlyingType()：列挙型の基となる型（デフォルトはint＝Int32）を返します。
• これらのメソッドを列挙型以外の型に対して呼び出すとArgumentExceptionがスローされるため、try-catchによる例外処理を組み合わせるのが安全です。