C#における列挙型(enum)は、プログラム内で特定の定数群に名前を付けて管理するための非常に強力な機能です。

開発の実務においては、この列挙型をそのまま扱うだけでなく、ユーザーインターフェースへの表示やデータベースへの保存、外部システムとの通信などのために、列挙型と文字列を相互に変換する場面が頻繁に発生します。

本記事では、C#で列挙型と文字列を変換する基本手法から、TryParseを用いた安全な変換、さらにはDescription属性を活用した高度な表示ロジックまで、エンジニアが実戦で即座に活用できる知識を網羅的に解説します。

最新のC#の機能を踏まえつつ、パフォーマンスや保守性を考慮した最適な実装方法を紐解いていきましょう。

目次 [ close ]
  1. C#におけるEnumと文字列変換の基本
    1. ToStringメソッドによる文字列への変換
    2. nameof演算子の活用
  2. 文字列からEnumへ変換する方法
    1. Enum.Parseによる変換
    2. Enum.TryParseによる安全な変換
    3. 大文字と小文字を区別しない変換
  3. Description属性を利用した高度な表示
    1. System.ComponentModel.Description属性の付与
    2. 反射（Reflection）を利用したDescriptionの取得
  4. Display属性（DataAnnotations）との違い
  5. C# 11以降の最新機能とパフォーマンス改善
    1. StringSyntaxAttributeによる支援
    2. Enum.GetNamesとEnum.GetValuesのジェネリック版
    3. パフォーマンスの懸念と解決策
  6. 数値と文字列、Enumの三者間変換
  7. まとめ

C#におけるEnumと文字列変換の基本

C#の列挙型は内部的には整数値として保持されていますが、コード上では「名前」として扱われます。

この「名前」を文字列として取得したり、逆に文字列から該当する列挙値を探し出したりする操作は、アプリケーション開発の基本中の基本です。

まずは、最もシンプルかつ頻用される手法から確認していきます。

ToStringメソッドによる文字列への変換

列挙型の値を文字列に変換する最も標準的な方法は、すべてのオブジェクトが継承しているToString()メソッドを呼び出すことです。

このメソッドを呼び出すだけで、定義された列挙子の名前をそのまま文字列として取得できます。

C#
using System;

public enum UserStatus
{
    Active,
    Inactive,
    Suspended
}

public class Program
{
    public static void Main()
    {
        UserStatus status = UserStatus.Active;

        // ToString()を使用して文字列に変換
        string statusString = status.ToString();

        Console.WriteLine($"列挙型の値: {status}");
        Console.WriteLine($"変換後の文字列: {statusString}");
    }
}
実行結果
列挙型の値: Active
変換後の文字列: Active

このように、特別な設定なしに識別子を文字列化できるのがC#の便利な点です。

なお、ToString("D")のように書式指定子を渡すことで、背後の数値(int型など)を文字列として取得することも可能です。

nameof演算子の活用

C# 6.0以降では、nameof演算子を使用して列挙型の名前を取得することもできます。

ただし、nameofはコンパイル時に文字列へ置換されるため、変数に格納された値ではなく、型そのものや特定の識別子名を固定で取得したい場合に適しています。

C#
string name = nameof(UserStatus.Active);
// 結果は "Active" となる

実行時の値に基づいて変換を行う場合はToString()を、ソースコード上の名前を安全に参照したい場合はnameofを使用するという使い分けが重要です。

文字列からEnumへ変換する方法

外部のリクエストパラメータやファイルから読み込んだ文字列を列挙型に戻す処理は、入力チェックと密接に関係します。

C#ではEnum.ParseおよびEnum.TryParseという2つの主要なメソッドが用意されています。

Enum.Parseによる変換

Enum.Parseは、文字列が列挙型に含まれる名前と一致する場合にその値を返します。

ただし、一致する名前が見つからない場合は例外（ArgumentException）が発生するため、入力値が確実に保証されている場合を除き、使用には注意が必要です。

C#
using System;

public enum OrderPriority
{
    Low,
    Medium,
    High
}

public class Program
{
    public static void Main()
    {
        string input = "High";

        // 文字列をEnumに変換
        OrderPriority priority = (OrderPriority)Enum.Parse(typeof(OrderPriority), input);

        Console.WriteLine($"変換成功: {priority}");
    }
}
実行結果
変換成功: High

Enum.TryParseによる安全な変換

実務で最も推奨されるのが、このEnum.TryParseです。

このメソッドは、変換に失敗しても例外を投げず、戻り値としてbool値を返します。

これにより、プログラムの異常終了を防ぎながら、安全にパース処理を行うことが可能です。

C#
using System;

public enum LogLevel
{
    Debug,
    Info,
    Warning,
    Error
}

public class Program
{
    public static void Main()
    {
        string input = "Warning";

        // ジェネリック版のTryParseを使用
        if (Enum.TryParse<LogLevel>(input, out LogLevel result))
        {
            Console.WriteLine($"変換に成功しました: {result}");
        }
        else
        {
            Console.WriteLine("無効な文字列です。");
        }
    }
}
実行結果
変換に成功しました: Warning

大文字と小文字を区別しない変換

Web APIのパラメータなどで、「info」や「INFO」といった表記の揺れを許容したい場合があります。

TryParseの第2引数（または第3引数）にtrueを渡すことで、大文字小文字を無視して検索できます。

C#
// 第2引数に true を指定して大文字小文字を無視する
bool success = Enum.TryParse<LogLevel>("error", true, out var result);

このオプションを指定することで、入力値の柔軟性が向上し、ユーザーフレンドリーなシステム構築が可能になります。

Description属性を利用した高度な表示

列挙型の識別子は、プログラミングの命名規則上、英語（アルファベット）にするのが一般的です。

しかし、システム画面には「実行中」「停止中」といった日本語の名称を表示したいケースが多いでしょう。

このような場合に便利なのがDescription属性です。

System.ComponentModel.Description属性の付与

まず、列挙型の各要素に対して、表示用文字列を属性として定義します。

C#
using System.ComponentModel;

public enum TaskStatus
{
    [Description("未着手")]
    NotStarted,

    [Description("進行中")]
    InProgress,

    [Description("完了済み")]
    Completed
}

反射（Reflection）を利用したDescriptionの取得

属性として定義した文字列を取得するには、System.Reflectionを使用して実行時に情報を抽出する必要があります。

これを毎回記述するのは非効率なため、拡張メソッドとして定義しておくのがベストプラクティスです。

C#
using System;
using System.ComponentModel;
using System.Reflection;

public static class EnumExtensions
{
    public static string GetDescription(this Enum value)
    {
        // フィールド情報を取得
        FieldInfo field = value.GetType().GetField(value.ToString());

        // Description属性を取得
        DescriptionAttribute attribute = field.GetCustomAttribute<DescriptionAttribute>();

        // 属性があればその値を、なければToString()の結果を返す
        return attribute == null ? value.ToString() : attribute.Description;
    }
}

public class Program
{
    public static void Main()
    {
        TaskStatus status = TaskStatus.InProgress;
        
        // 拡張メソッドで日本語名を取得
        string displayName = status.GetDescription();

        Console.WriteLine($"列挙値: {status}");
        Console.WriteLine($"表示名: {displayName}");
    }
}
実行結果
列挙値: InProgress
表示名: 進行中

このように、コードとしての分かりやすさと、表示用文字列の管理を両立させることができます。

Display属性（DataAnnotations）との違い

ASP.NET CoreやEntity Frameworkを使用している環境では、Description属性の代わりにSystem.ComponentModel.DataAnnotations.Display属性が使われることもあります。

属性名名前空間主な用途
DescriptionSystem.ComponentModel全般的な説明用。Windows Formsなどでも利用。
DisplaySystem.ComponentModel.DataAnnotationsASP.NET Core MVCのラベル表示、多言語化対応。

多言語化(ローカライズ)が必要なプロジェクトでは、リソースファイルと連携できるDisplay属性を選択するのが一般的です。

C# 11以降の最新機能とパフォーマンス改善

近年のC#および.NETのアップデートでは、列挙型の文字列処理に関してもパフォーマンス向上が図られています。

StringSyntaxAttributeによる支援

C# 11から導入されたStringSyntaxAttributeは、文字列が特定の形式（日付、正規表現、Enum名など）であることをコンパイラやIDEに伝えることができます。

これにより、コーディング中の入力補完や静的解析の精度が向上します。

Enum.GetNamesとEnum.GetValuesのジェネリック版

かつての.NETでは、列挙型の全名称を取得するEnum.GetNamesはstring[]を返していましたが、最近のバージョンではジェネリック版が追加され、ボックス化のオーバーヘッドを抑えた効率的な列挙が可能になっています。

C#
// 全ての名称をループで取得
foreach (var name in Enum.GetNames<TaskStatus>())
{
    Console.WriteLine(name);
}

パフォーマンスの懸念と解決策

列挙型の文字列変換、特にリフレクションを使用したDescription属性の取得は、大量のデータ処理の中ではボトルネックになる可能性があります。

  1. キャッシュの利用: 一度取得した属性値はConcurrentDictionaryなどにキャッシュし、2回目以降は辞書から取得するように実装します。
  2. Source Generatorの活用: コンパイル時に変換コードを自動生成することで、実行時のリフレクションを完全に排除する手法も注目されています。

数値と文字列、Enumの三者間変換

実務では「文字列 <-> Enum <-> 数値」という三方向の変換が必要になることが多々あります。

特にデータベースとのやり取りでは数値で保存し、APIでは文字列で出力するといったケースです。

C#
public enum Category
{
    Food = 1,
    Electronics = 2,
    Books = 3
}

// 1. 数値からEnumへ
Category cat = (Category)2; // Electronics

// 2. Enumから数値へ
int val = (int)Category.Books; // 3

// 3. 数値の文字列からEnumへ
string numStr = "1";
if (Enum.TryParse<Category>(numStr, out var result))
{
    // result は Category.Food となる
}

数値の文字列をパースする場合、定義されていない数値（例：”99″）であってもエラーにならず数値として変換されてしまう仕様があります。

これを防ぐには、変換後にEnum.IsDefinedメソッドを使用して、定義済みの値かどうかを検証する必要があります。

C#
if (Enum.TryParse<Category>("99", out var result) && Enum.IsDefined(typeof(Category), result))
{
    // 有効な定義値の場合のみここを通る
}
else
{
    // 定義されていない数値の場合はこちら
}

まとめ

C#におけるEnumと文字列の相互変換は、単なる型変換以上の意味を持ちます。

それは、システム内部の論理構造と、外部の世界（ユーザーや他システム）を繋ぐインターフェースとしての役割を果たしているからです。

本記事で解説した内容のポイントを振り返ります。

基本変換

単純な名前取得には ToString() を使用し、逆変換では例外を防ぐために Enum.TryParse<T> を選ぶのが 鉄則 です。

表示の工夫

ユーザーフレンドリーな名称を表示したい場合は、[Description] 属性（または DescriptionAttribute）と拡張メソッドを組み合わせることで、コードの可読性を保ちながら柔軟に表示できます。

安全性と精度

大文字小文字の区別設定（例: Enum.TryParse<T>(value, ignoreCase: true, out var result) の利用）や Enum.IsDefined による数値妥当性チェックを組み合わせることで、堅牢なアプリケーションを構築できます。

最新動向

C# 11以降の言語機能やジェネリック版メソッドを活用し、パフォーマンスと開発体験を両立させることが現代的なエンジニアリングの方向性です（例: Enum.Parse<T> やその他のジェネリックユーティリティ）。

これらの手法を適切に使い分けることで、バグが少なくメンテナンス性の高いコードを実現できるはずです。

プロジェクトの要件や規模に応じて、最適な変換ロジックを選択してください。