C#を用いたアプリケーション開発において、状態の管理や種別の定義に欠かせないのが列挙型（enum）です。

列挙型は内部的には整数値として扱われており、データベースへの保存やネットワーク通信、あるいはフラグ管理などの場面で、列挙型と整数型（int）を相互に変換する必要が生じます。

しかし、単純なキャストだけで済ませてしまうと、定義されていない値が入り込んだり、型の不一致によるランタイムエラーが発生したりするリスクがあります。

本記事では、C#におけるenumとintの相互変換方法から、実践的なバリデーション、さらにパフォーマンスや保守性を考慮した注意点までをプロフェッショナルな視点で詳しく解説します。

目次 [ close ]
  1. C#におけるenumの基本構造と整数型との関係
  2. enumからintへ変換する方法
    1. 明示的なキャストによる変換
    2. Convertクラスを使用した変換
  3. intからenumへ変換する方法
    1. キャストによる変換と挙動
  4. 安全な変換のためのバリデーション
    1. Enum.IsDefinedによるチェック
    2. Enum.TryParseの活用（文字列からの変換を含む）
  5. enumの基底型の変更（int以外への対応）
    1. 基底型を指定する定義方法
  6. ビットフラグとしてのenumと数値変換
    1. Flags属性の利用例
  7. 実践的な変換における注意点とベストプラクティス
    1. 1. 0（デフォルト値）の扱い
    2. 2. switch文での網羅性チェック
    3. 3. JSONシリアライズ時の挙動
  8. パフォーマンスを極める：Unsafe.Asによる変換
  9. enumとintの対応表
  10. まとめ

C#におけるenumの基本構造と整数型との関係

C#の列挙型は、意味のある名前を整数値に結びつけるためのデータ型です。

デフォルトの状態では、enumの各要素にはint型（System.Int32）の数値が割り当てられます。

列挙型を定義する際、明示的に数値を指定しない場合は0から順に割り振られますが、特定の数値を割り当てることも可能です。

C#
using System;

namespace EnumSample
{
    // デフォルトのenum定義（内部的にはint）
    public enum UserStatus
    {
        Inactive = 0,
        Active = 1,
        Suspended = 2,
        Deleted = 99
    }

    class Program
    {
        static void Main()
        {
            // 列挙型の値を表示
            UserStatus status = UserStatus.Active;
            Console.WriteLine($"現在のステータス: {status}");
        }
    }
}
実行結果
現在のステータス: Active

C#のenumは厳密に型指定されていますが、その基底にある型（Underlying Type）はデフォルトでintです。

この仕組みを理解することが、安全な型変換の第一歩となります。

enumからintへ変換する方法

列挙型の値を整数値（int）として取り出す最も一般的で効率的な方法は、明示的なキャストを使用することです。

明示的なキャストによる変換

列挙型の変数の前に(int)を付けることで、その要素に割り当てられた整数値を取得できます。

この処理は非常に高速であり、コンパイル時に型チェックが行われるため、基本的には安全です。

C#
UserStatus status = UserStatus.Suspended;

// enumからintへのキャスト
int intValue = (int)status;

Console.WriteLine($"Enumの値: {status}");
Console.WriteLine($"変換後の数値: {intValue}");
実行結果
Enumの値: Suspended
変換後の数値: 2

Convertクラスを使用した変換

キャスト以外にもConvert.ToInt32()メソッドを使用する方法があります。

この方法は、対象がobject型として渡されてくる場合などに有用です。

C#
object objStatus = UserStatus.Deleted;
int convertedValue = Convert.ToInt32(objStatus);

Console.WriteLine($"Convertを使用した結果: {convertedValue}");

ただし、パフォーマンスの観点からは直接のキャストの方が優れているため、型が明確な場合はキャストを選択するのが定石です。

intからenumへ変換する方法

整数値を列挙型に戻す場合も、基本的にはキャストを使用します。

しかし、intからenumへの変換には「定義されていない値が変換できてしまう」という重要な注意点があります。

キャストによる変換と挙動

以下のコードでは、整数値を列挙型にキャストしています。

C#
int input = 1;
UserStatus status = (UserStatus)input;

Console.WriteLine($"数値 {input} は {status} に変換されました。");

// 定義されていない数値のキャスト
int unknownInput = 50;
UserStatus unknownStatus = (UserStatus)unknownInput;

Console.WriteLine($"数値 {unknownInput} は {unknownStatus} に変換されました。");
実行結果
数値 1 は Active に変換されました。
数値 50 は 50 に変換されました。

上記の結果からわかる通り、C#ではenumの定義に含まれていない数値であっても、キャスト自体は成功してしまいます。

これはC#の仕様ですが、プログラムの論理的なバグを誘発する可能性があるため、適切なバリデーションが必要です。

安全な変換のためのバリデーション

外部入力やデータベースの値をenumに変換する際は、その数値が列挙型として有効かどうかを確認しなければなりません。

Enum.IsDefinedによるチェック

Enum.IsDefinedメソッドを使用すると、指定した整数値が列挙型の定義内に存在するかどうかを判定できます。

C#
int targetValue = 50;

if (Enum.IsDefined(typeof(UserStatus), targetValue))
{
    UserStatus status = (UserStatus)targetValue;
    Console.WriteLine($"有効なステータス: {status}");
}
else
{
    Console.WriteLine($"{targetValue} は UserStatus に定義されていません。");
}
実行結果
50 は UserStatus に定義されていません。

注意点： Enum.IsDefinedはリフレクションを使用するため、大量のデータをループ内で処理するようなケースではパフォーマンスに影響を与える可能性があります。

Enum.TryParseの活用（文字列からの変換を含む）

数値が文字列として渡される場合や、より柔軟なパースが必要な場合はEnum.TryParseが便利です。

C#
string inputStr = "99";

if (Enum.TryParse(inputStr, out UserStatus result))
{
    if (Enum.IsDefined(typeof(UserStatus), result))
    {
        Console.WriteLine($"パース成功: {result}");
    }
}

enumの基底型の変更（int以外への対応）

デフォルトではintですが、メモリ使用量を抑えたい場合や、外部システムの仕様に合わせるために、byteやlongなどを基底型として指定できます。

基底型を指定する定義方法

C#
// byte型を基底とするenum
public enum ErrorCode : byte
{
    None = 0,
    Timeout = 1,
    Unknown = 255
}

class Program
{
    static void Main()
    {
        ErrorCode code = ErrorCode.Unknown;
        byte byteValue = (byte)code;
        
        Console.WriteLine($"ErrorCode: {code}, Value: {byteValue}");
    }
}

この場合、キャスト先も対応する型（この例ではbyte）にする必要があります。

intにキャストすることも可能ですが、データの範囲に注意してください。

ビットフラグとしてのenumと数値変換

複数の状態を組み合わせて保持したい場合、[Flags]属性を使用します。

この場合、enumとintの変換は「ビット演算」を前提としたものになります。

Flags属性の利用例

C#
[Flags]
public enum Permissions
{
    None = 0,
    Read = 1,    // 2^0
    Write = 2,   // 2^1
    Execute = 4, // 2^2
    All = Read | Write | Execute
}

class Program
{
    static void Main()
    {
        // ReadとWriteのフラグを立てる
        Permissions myPerm = Permissions.Read | Permissions.Write;
        
        // intに変換
        int intValue = (int)myPerm;
        Console.WriteLine($"フラグ値 (int): {intValue}");
        
        // intから逆変換
        Permissions restoredPerm = (Permissions)3;
        Console.WriteLine($"復元されたフラグ: {restoredPerm}");
    }
}
実行結果
フラグ値 (int): 3
復元されたフラグ: Read, Write

Flags属性が付与されている場合、Enum.IsDefinedの挙動が変わる点に注意してください。

複合されたフラグ値（例：3）に対しては、明示的に定義されていない限りIsDefinedはfalseを返します。

実践的な変換における注意点とベストプラクティス

開発現場でトラブルを防ぐために、以下のポイントを意識することが重要です。

1. 0（デフォルト値）の扱い

C#の構造体やクラスのフィールドとしてenumを持つ場合、初期化しないとデフォルト値である0が割り当てられます。

そのため、enumの定義には必ず「0」の値を含め、かつそれが「未定義」や「初期状態」を示すように設計するのがベストプラクティスです。

2. switch文での網羅性チェック

intから変換したenumをswitch文で扱う場合、default句を必ず用意しましょう。

予期せぬ数値がキャストされて入り込んだ場合でも、エラーハンドリングが可能になります。

C#
public void ProcessStatus(UserStatus status)
{
    switch (status)
    {
        case UserStatus.Active:
            // 処理
            break;
        default:
            throw new ArgumentOutOfRangeException(nameof(status), "不正なステータスです。");
    }
}

3. JSONシリアライズ時の挙動

Web APIなどでenumを扱う際、JSONには数値（int）として出力するのか、文字列（string）として出力するのかを検討する必要があります。

System.Text.Jsonではデフォルトで数値として扱われますが、可読性を重視する場合はJsonStringEnumConverterを使用して文字列に変換することが一般的です。

パフォーマンスを極める：Unsafe.Asによる変換

極限までパフォーマンスが要求されるゲームエンジンや高頻度のデータ処理では、キャストのオーバーヘッドすら削減したい場合があります。

その際、.NET Core以降で利用可能なSystem.Runtime.CompilerServices.Unsafe.Asを使用する手法があります。

C#
using System.Runtime.CompilerServices;

UserStatus status = UserStatus.Active;

// 型チェックなしの高速な変換
int fastInt = Unsafe.As<UserStatus, int>(ref status);

ただし、これは安全性を犠牲にする方法であるため、通常のビジネスロジックでの使用は推奨されません。

あくまで内部最適化のための手段として知っておく程度で十分です。

enumとintの対応表

変換方向方法特徴
enum → int(int)Value最速。最も一般的。
enum → intConvert.ToInt32()object型からの変換に便利。
int → enum(MyEnum)Value高速だが、未定義の値も変換される。
int → enumEnum.IsDefined()値の妥当性を検証できるが低速。
int → enumEnum.TryParse()文字列混在や安全なパースに利用。

まとめ

C#におけるenumとintの相互変換は、基本的にはキャストを用いることで簡潔に記述できます。

しかし、その背後には型安全性やバリデーションの重要性が隠れています。

  • 単純な変換は(int)または(EnumType)のキャストを使用する。
  • 外部からの入力値を変換する際は、必ずEnum.IsDefinedやEnum.TryParseで妥当性を確認する。
  • enumの設計時は「0」をデフォルト値として定義し、予期せぬ動作を防ぐ。
  • フラグ管理を行う場合は[Flags]属性を適切に付与する。

これらの原則を守ることで、堅牢でメンテナンス性の高いC#プログラムを記述できるようになります。

データの整合性を保ちつつ、列挙型のメリットを最大限に活かした実装を心がけましょう。