【C#入門】enumをToString()で文字列に変換する方法

2024年8月31日

C#でプログラミングを行う際、enum（列挙型）の値を文字列として扱いたい場面がよくあります。そんなとき、ToString()メソッドを使用すると簡単に変換できます。この記事では、C#におけるenumとToString()メソッドの使い方について、初心者の方にも分かりやすく解説していきます。

enumとは

まず、enumについて簡単に説明しましょう。enumは、名前付きの定数のセットを表現するためのデータ型です。関連する値のグループを定義する際に非常に便利で、コードの可読性を高めてくれます。

以下は、曜日を表すenumの例です：

enum DayOfWeek
{
    Sunday,
    Monday,
    Tuesday,
    Wednesday,
    Thursday,
    Friday,
    Saturday
}

enumにToString()を使う

enumの値を文字列に変換するには、単純にToString()メソッドを呼び出すだけです。以下に基本的な使い方を示します：

DayOfWeek today = DayOfWeek.Wednesday;
string dayString = today.ToString();
Console.WriteLine(dayString); // 出力: Wednesday

このコードでは、DayOfWeek.Wednesdayという列挙型の値を文字列”Wednesday”に変換しています。

より実践的な例

実際のプログラミングでは、enumの値を文字列に変換して様々な処理を行うことがあります。以下に、より実践的な例を示します：

enum Color
{
    Red,
    Green,
    Blue,
    Yellow
}

class Program
{
    static void Main(string[] args)
    {
        Color[] colors = { Color.Red, Color.Green, Color.Blue, Color.Yellow };

        foreach (Color color in colors)
        {
            string colorName = color.ToString();
            Console.WriteLine($"選択された色は{colorName}です。");
        }
    }
}

このプログラムを実行すると、次のような出力が得られます：

選択された色はRedです。
選択された色はGreenです。
選択された色はBlueです。
選択された色はYellowです。

カスタムToString()の実装

デフォルトのToString()メソッドは列挙子の名前をそのまま返しますが、カスタムの文字列を返したい場合もあるでしょう。そのような場合は、次のようにenumにカスタム属性を付けて、拡張メソッドを定義することができます：

using System;
using System.ComponentModel;
using System.Reflection;

enum Fruit
{
    [Description("赤いりんご")]
    Apple,
    [Description("黄色いバナナ")]
    Banana,
    [Description("オレンジ色のオレンジ")]
    Orange
}

static class EnumExtensions
{
    public static string ToDescription(this Enum value)
    {
        FieldInfo field = value.GetType().GetField(value.ToString());
        DescriptionAttribute attribute = field.GetCustomAttribute<DescriptionAttribute>();
        return attribute == null ? value.ToString() : attribute.Description;
    }
}

class Program
{
    static void Main(string[] args)
    {
        Fruit fruit = Fruit.Apple;
        Console.WriteLine(fruit.ToString()); // 出力: Apple
        Console.WriteLine(fruit.ToDescription()); // 出力: 赤いりんご
    }
}

このように、enumとToString()を組み合わせることで、列挙型の値を簡単に文字列として扱うことができます。これは、ユーザーインターフェースでの表示、ログ出力、デバッグなど、様々な場面で活用できる技術です。この記事で紹介した方法を使いこなすことで、より柔軟で読みやすいC#プログラムを書くことができるでしょう。