C#でenumとintの変換を簡単に理解する方法

2024年9月17日2024年12月14日

C#のenumはプログラム内で定数を扱う際に便利なデータ型ですが、
時にはenumをintやstringに変換したり、その逆を行う必要があります。

この記事ではC#でのenumとintの変換方法について詳しく解説します。
enumの基礎から、キャストの際の注意点までを網羅し、具体的なコード例を使ってわかりやすく説明します。
初心者から上級者まで、enumとintのキャストについて完全理解できるようになります。

記事のポイント

C#でのenumとintの変換方法と使用例
enumの既定値や数値指定の方法
キャストや型指定の際に気をつけるべき点

C#でenumとintを変換する方法

enumとintの基本的なキャスト方法

C#ではenumをint型にキャストすることができます。
この操作は非常にシンプルで、enumの内部では整数として扱われるためです。
以下に、基本的なキャストの例を示します。

enum Days { Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday };

int dayValue = (int)Days.Monday;
Console.WriteLine(dayValue);  // 出力: 1

このように、enumの値をintにキャストすることで、enumが持つ数値を取得できます。

enumの既定値

C#でenumを定義すると、既定値として0が割り当てられます。
つまり、定義されていない場合最初の要素は0となります。

enum Colors { Red, Green, Blue };

Colors defaultColor = default(Colors);
Console.WriteLine(defaultColor);  // 出力: Red

この例では、defaultColorにColors.Redが割り当てられます。
enumの順番に従い、最初の値が0であり、それが既定値となります。

enumで使用できる文字は？

enumには有効な識別子となる文字のみが使用可能です。
数字で始まる名前や予約語は使えません。
また、enum内の値はユニークである必要があります。

enum Shapes { Circle, Square, Triangle, _Rectangle };

このように、識別子として使用できるのはアルファベット、アンダースコア(_)などが含まれますが、
数値や特殊文字の使用は制限されます。

C# enumの順番と数値指定の方法

C# enumの順番は？

C#のenumは、宣言順に数値が自動的に割り当てられます。
特に指定しない場合、0から順にインクリメントされます。

enum Seasons { Winter, Spring, Summer, Autumn };

int summerValue = (int)Seasons.Summer;
Console.WriteLine(summerValue);  // 出力: 2

enumの順番はプログラム全体の一貫性を保つために重要です。

enumで数値を指定する方法

enumには手動で数値を割り当てることができます。
これにより、既定の数値順ではなく、特定の値を持つようにカスタマイズできます。

enum Status { 
　Inactive = -1, 
　Active = 1, 
　Pending = 0
};

この例では、Inactiveに-1、Activeに1、Pendingに0が指定されています。
これにより、enumの使い方が柔軟になります。

enumとintのキャストの注意点

enumのキャストが面倒に感じる場面

enumをintにキャストするのは簡単ですが、逆にintをenumにキャストする際には注意が必要です。
キャスト範囲外の値が指定されると、エラーは発生せず、予期しない動作が起こる可能性があります。

int invalidValue = 100;
Days day = (Days)invalidValue;
Console.WriteLine(day);  // 出力: 100 (存在しないenum値)

このように、enumに存在しない値をキャストしてもエラーが発生しないため、実際のアプリケーションでは特定の範囲内であるかどうかを確認する必要があります。

enumの型指定の重要性

enumは内部で整数として扱われますが、int以外の型も指定可能です。
例えば、byteやlongなどの型を指定して使用することができます。

enum Permissions : byte { 
　Read = 1, 
　Write = 2, 
　Execute = 4 
};

この例では、Permissions enumがbyte型で定義されています。
これにより、メモリ使用量を抑えたり、特定の型との互換性を確保したりすることができます。

C#のenumと文字列の変換方法

enumのstring変換の方法

C#では、enumと文字列を相互に変換することが可能です。
以下のコード例では、enumを文字列に変換しています。

enum Days { Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday };

string dayName = Days.Monday.ToString();
Console.WriteLine(dayName);  // 出力: Monday

このように、ToString()メソッドを使うことで簡単に文字列へ変換できます。

enumの文字列を紐づけ実践方法

時には、enumの値にカスタムの文字列を紐づけたい場合があります。
このような場合、[Description]属性を利用することで、enumの各値に説明を付加できます。

using System.ComponentModel;

enum Days {
    [Description("First day of the week")]
    Sunday,
    [Description("Second day of the week")]
    Monday
}

// 拡張メソッド Days.Sunday.GetEnumDescription() でDescriptionを呼び出す
public static class EnumExtensions {
    public static string GetEnumDescription(this Enum value) {
        FieldInfo fi = value.GetType().GetField(value.ToString());
        DescriptionAttribute[] attributes = (DescriptionAttribute[])fi.GetCustomAttributes(typeof(DescriptionAttribute), false);

        if (attributes != null && attributes.Length > 0) {
            return attributes[0].Description;
        } else {
            return value.ToString();
        }
    }
}

string description = Days.Sunday.GetEnumDescription();
Console.WriteLine(description);  // 出力: First day of the week

Description属性を使うことで、enum値に関連する文字列情報を管理できます。

enumは継承できる？

enumはクラスやインターフェースのように継承をサポートしていません。
これはenum自体が単なる値型であり、クラスや構造体とは異なるためです。
そのため、enumの継承を試みるとコンパイルエラーが発生します。

ただし、継承のようにenumを拡張したい場合は別の方法でアプローチする必要があります。
たとえば、複数のenumを組み合わせたり、拡張メソッドを利用してenumに機能を追加する方法が考えられます。

// Enumのように見える複数のクラスで継承のような振る舞いを実現する
public class BaseStatus
{
    public virtual string StatusName { get; }
}

public class ReadyStatus : BaseStatus
{
    public override string StatusName => "Ready";
}

public class RunningStatus : BaseStatus
{
    public override string StatusName => "Running";
}

このように、クラスでenum的な振る舞いを定義し、継承を使って新たなステータスを追加することが可能です。
enum自体の継承はできませんが、このようにして似たような挙動を再現することができます。