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

C#におけるType.GetEnumNames()メソッドは、現在の列挙型（enum）に含まれるすべてのメンバーの名前を文字列配列として返すために使用されます。この記事では、基本的な構文から実際のコード例まで、具体的な使い方をわかりやすく解説します。

構文

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

public virtual string[] GetEnumNames ();

戻り値はstring[]型であり、列挙型に定義されたすべての定数名が格納されます。

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

まず、string型のような列挙型以外の型に対してGetEnumNames()メソッドを呼び出した場合の例を見てみましょう。

using System;
public class Demo {
    enum Vehicle {Car, Bus, Bike}
    public static void Main(){
        try {
            Type type = typeof(string);
            string[] str = type.GetEnumNames();
            Console.WriteLine("GetEnumName() to return the constant name = " + str);
            Console.WriteLine("Listing 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

この結果からわかるように、対象が列挙型ではない場合にはArgumentException例外がスローされ、catchブロック内の処理が実行されます。このため、GetEnumNames()を呼び出す前に型が列挙型であるかどうかを確認するか、try-catchによる例外処理を適切に行うことが重要です。

例2：列挙型に呼び出した場合

次に、独自に定義したVehicle列挙型のインスタンスからGetEnumNames()メソッドを呼び出した場合の例を見てみましょう。

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);
            Console.WriteLine("Listing 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[]
Listing constants ..
Car Bus Bike airplane

この例では、GetType()メソッドでVehicle列挙型のTypeオブジェクトを取得し、その後GetEnumNames()を呼び出しています。その結果、「Car」「Bus」「Bike」「airplane」という4つの定数名がすべて文字列配列として正しく取得できていることが確認できます。

まとめ

• Type.GetEnumNames()は、列挙型に含まれるすべての定数名をstring[]型で返します。
• 対象が列挙型でない場合、ArgumentExceptionがスローされるため、例外処理が必要です。
• typeof演算子やGetType()メソッドで取得したTypeオブジェクトに対して呼び出すことができます。