C# enumの使い方を初心者向けに徹底解説｜定義・変換・比較・Flagsまでわかる完全ガイド

はじめに

C#でプログラムを書いていると、「状態」「種類」「区分」「権限」など、あらかじめ決まった選択肢の中から値を扱いたい場面がよくあります。

たとえば、注文の状態を表す場合に、次のような数値で管理することもできます。

C#
int status = 1;

しかし、これだけでは1が何を意味しているのか分かりにくいです。1が「処理中」なのか、「完了」なのか、「キャンセル」なのかは、コードを読んだだけでは判断できません。

このような場面で役立つのが、C#のenumです。

enumを使うと、数値に分かりやすい名前を付けて扱えるため、コードの可読性が高くなり、入力ミスや管理ミスも減らせます。

この記事では、C#のenumについて、基本的な定義方法から、数値・文字列との変換、比較、一覧取得、Flags属性を使ったビット演算、実践的な設計ポイントまで初心者向けに詳しく解説します。

1. C# enumとは？初心者が最初に押さえるべき基本

1-1. enumは「決まった選択肢」を名前付きで扱うための型

C#のenumは、あらかじめ決められた値の集合を名前付きで定義するための型です。

正式には「列挙型」と呼ばれます。

たとえば、注文状態を表す場合、次のように定義できます。

C#
public enum OrderStatus
{
    Pending,
    Processing,
    Completed,
    Canceled
}

このように定義すると、注文状態をOrderStatus.PendingやOrderStatus.Completedのように分かりやすい名前で扱えます。

C#
OrderStatus status = OrderStatus.Processing;

enumは、内部的には数値を持っています。しかし、コード上では名前で扱えるため、数値を直接書くよりも意味が明確になります。

1-2. enumを使うメリット：可読性・保守性・入力ミス防止

enumを使う大きなメリットは、コードの意味が読み取りやすくなることです。

たとえば、次のコードを見てください。

C#
int userType = 2;

この2が何を意味するのかは、コードだけでは分かりません。

一方、enumを使うと次のように書けます。

C#
UserType userType = UserType.Admin;

このコードであれば、「ユーザー種別が管理者である」ことがすぐに分かります。

また、enumを使うことで、定義されていない値を誤って入力するリスクも減らせます。文字列で管理する場合は、"Admin"を"Admn"のように打ち間違えてもコンパイル時には気づけないことがあります。

C#
string userType = "Admn";

しかし、enumであれば、存在しないメンバー名を指定するとコンパイルエラーになります。

C#
UserType userType = UserType.Admn; // エラー

このように、enumは可読性、保守性、安全性を高めるために役立ちます。

1-3. intやstringだけで管理する場合との違い

enumを使わずに、intやstringで状態を管理することもできます。

たとえば、intで管理する場合は次のようになります。

C#
int status = 1;

if (status == 1)
{
    Console.WriteLine("処理中です");
}

このコードでは、1の意味を別の資料やコメントで確認しなければなりません。

次に、stringで管理する場合です。

C#
string status = "Processing";

if (status == "Processing")
{
    Console.WriteLine("処理中です");
}

stringは数値より意味が分かりやすいですが、タイプミスに弱いという問題があります。

C#
string status = "Procesing"; // Processingのつづり間違い

このようなミスはコンパイル時には検出されにくく、実行時の不具合につながります。

enumを使うと、次のように書けます。

C#
OrderStatus status = OrderStatus.Processing;

if (status == OrderStatus.Processing)
{
    Console.WriteLine("処理中です");
}

このコードは意味が明確で、存在しない値を使おうとするとコンパイルエラーになるため、安全です。

1-4. enumがよく使われる場面：状態・種類・権限・曜日など

enumは、選択肢があらかじめ決まっている場面でよく使われます。

代表的な例としては、次のようなものがあります。

C#
public enum OrderStatus
{
    Pending,
    Processing,
    Completed,
    Canceled
}

注文状態の管理に使えます。

C#
public enum PaymentType
{
    Cash,
    CreditCard,
    BankTransfer,
    ElectronicMoney
}

支払い方法の種類を表せます。

C#
public enum UserRole
{
    Guest,
    Member,
    Admin
}

ユーザー権限や役割を表せます。

C#
public enum DayOfWeekType
{
    Sunday,
    Monday,
    Tuesday,
    Wednesday,
    Thursday,
    Friday,
    Saturday
}

曜日のように決まった値を扱う場合にも使えます。

このように、enumは「選択肢が固定されているデータ」を扱うときに非常に便利です。

2. C# enumの基本的な定義方法

2-1. enumの基本構文

C#でenumを定義する基本構文は次のとおりです。

C#
public enum EnumName
{
    Value1,
    Value2,
    Value3
}

たとえば、注文状態を表すenumは次のように定義できます。

C#
public enum OrderStatus
{
    Pending,
    Processing,
    Completed,
    Canceled
}

enumはクラスの外側に定義することも、クラスの内側に定義することもできます。

C#
public class Order
{
    public enum Status
    {
        Pending,
        Processing,
        Completed,
        Canceled
    }
}

ただし、複数のクラスで使い回す場合は、クラスの外側に独立した型として定義することが多いです。

2-2. enum名・メンバー名の命名ルール

C#では、enum名やメンバー名には分かりやすい名前を付けることが大切です。

一般的には、enum名にはパスカルケースを使います。

C#
public enum OrderStatus
{
    Pending,
    Processing,
    Completed
}

パスカルケースとは、単語の先頭を大文字にする書き方です。

C#
OrderStatus
PaymentType
UserRole

enumのメンバー名も同じくパスカルケースで書くのが一般的です。

C#
public enum PaymentType
{
    Cash,
    CreditCard,
    BankTransfer
}

また、enum名は単数形にすることが多いです。

C#
public enum UserRole
{
    Guest,
    Member,
    Admin
}

UserRolesのような複数形ではなく、1つの値を表す型としてUserRoleとするほうが自然です。

ただし、Flags属性を使って複数の値を組み合わせるenumでは、複数形の名前が使われることもあります。

C#
[Flags]
public enum Permissions
{
    None = 0,
    Read = 1,
    Write = 2,
    Delete = 4
}

2-3. enumの値はデフォルトで0から始まる

C#のenumは、何も数値を指定しない場合、最初のメンバーに0が割り当てられます。

C#
public enum OrderStatus
{
    Pending,     // 0
    Processing,  // 1
    Completed,   // 2
    Canceled     // 3
}

次のようにintへ変換すると、内部の数値を確認できます。

C#
OrderStatus status = OrderStatus.Completed;

Console.WriteLine((int)status); // 2

enumは名前で扱うことが多いですが、内部的には数値として管理されています。

2-4. enumに任意の数値を割り当てる方法

enumの各メンバーには、任意の数値を明示的に割り当てることができます。

C#
public enum OrderStatus
{
    Pending = 10,
    Processing = 20,
    Completed = 30,
    Canceled = 40
}

この場合、OrderStatus.Completedをintに変換すると30になります。

C#
OrderStatus status = OrderStatus.Completed;

Console.WriteLine((int)status); // 30

一部の値だけを指定することもできます。

C#
public enum SampleType
{
    A = 1,
    B,     // 2
    C,     // 3
    D = 10,
    E      // 11
}

明示的に値を指定したメンバーの次は、その値に1を足した数値になります。

任意の数値を割り当てる場面としては、データベースに保存する値や外部APIの仕様に合わせる場合などがあります。

2-5. enumの基になる型をbyteやlongに変更する方法

C#のenumは、デフォルトではint型を基にしています。

しかし、必要に応じてbyteやlongなどに変更できます。

C#
public enum ErrorCode : long
{
    None = 0,
    NotFound = 10000000000,
    Unauthorized = 20000000000
}

byteを使う例は次のとおりです。

C#
public enum Level : byte
{
    Low = 1,
    Medium = 2,
    High = 3
}

基になる型として使えるのは、整数型です。

たとえば、byte、short、int、longなどが使えます。stringやdoubleを基になる型にすることはできません。

C#
public enum Status : string // エラー
{
    Active = "Active"
}

enumに文字列の値を直接持たせることはできないため、画面表示用の文字列が必要な場合は別の方法で対応します。

3. C# enumの基本的な使い方

3-1. enum型の変数を宣言・代入する

enum型の変数は、通常の型と同じように宣言できます。

C#
OrderStatus status;

値を代入する場合は、Enum名.メンバー名の形で指定します。

C#
OrderStatus status = OrderStatus.Pending;

後から別の値を代入することもできます。

C#
status = OrderStatus.Completed;

enumを使うと、変数に何の種類の値が入るのかが明確になります。

C#
PaymentType paymentType = PaymentType.CreditCard;
UserRole role = UserRole.Admin;

このように、意味のある型として扱える点がenumの強みです。

3-2. if文でenumを判定する

enumはif文で簡単に判定できます。

C#
OrderStatus status = OrderStatus.Completed;

if (status == OrderStatus.Completed)
{
    Console.WriteLine("注文は完了しています");
}

複数の条件を判定することもできます。

C#
if (status == OrderStatus.Pending || status == OrderStatus.Processing)
{
    Console.WriteLine("注文はまだ処理中です");
}

enumを使うことで、条件式の意味が分かりやすくなります。

C#
if (status == OrderStatus.Canceled)
{
    Console.WriteLine("注文はキャンセルされました");
}

数値だけで比較するよりも、何を判定しているのかが明確です。

3-3. switch文・switch式でenumを分岐する

enumはswitch文との相性が非常に良いです。

C#
OrderStatus status = OrderStatus.Processing;

switch (status)
{
    case OrderStatus.Pending:
        Console.WriteLine("注文受付中です");
        break;

    case OrderStatus.Processing:
        Console.WriteLine("処理中です");
        break;

    case OrderStatus.Completed:
        Console.WriteLine("完了しました");
        break;

    case OrderStatus.Canceled:
        Console.WriteLine("キャンセルされました");
        break;
}

C#のswitch式を使うと、より簡潔に書けます。

C#
string message = status switch
{
    OrderStatus.Pending => "注文受付中です",
    OrderStatus.Processing => "処理中です",
    OrderStatus.Completed => "完了しました",
    OrderStatus.Canceled => "キャンセルされました",
    _ => "不明な状態です"
};

Console.WriteLine(message);

switchを使うと、enumの各値に対して処理を分けやすくなります。

3-4. メソッドの引数や戻り値にenumを使う

enumはメソッドの引数として使うことができます。

C#
public void PrintStatus(OrderStatus status)
{
    Console.WriteLine($"現在の状態: {status}");
}

呼び出し側では、次のように指定します。

C#
PrintStatus(OrderStatus.Completed);

戻り値として使うこともできます。

C#
public OrderStatus GetOrderStatus(int orderId)
{
    return OrderStatus.Processing;
}

メソッドの引数や戻り値にenumを使うと、そのメソッドがどのような種類の値を扱うのかが明確になります。

C#
public bool CanCancel(OrderStatus status)
{
    return status == OrderStatus.Pending || status == OrderStatus.Processing;
}

このようなコードは、数値や文字列で管理するよりも読みやすくなります。

3-5. クラスやプロパティでenumを使う実践例

enumはクラスのプロパティとしてもよく使われます。

C#
public enum OrderStatus
{
    Pending,
    Processing,
    Completed,
    Canceled
}

public class Order
{
    public int Id { get; set; }
    public OrderStatus Status { get; set; }
}

このクラスを使うと、注文情報に状態を持たせることができます。

C#
Order order = new Order
{
    Id = 1,
    Status = OrderStatus.Pending
};

if (order.Status == OrderStatus.Pending)
{
    Console.WriteLine("注文は受付中です");
}

プロパティにenumを使うことで、代入できる値の候補が限定されます。

C#
order.Status = OrderStatus.Completed;

Visual StudioなどのIDEでは補完も効くため、入力ミスも減らせます。

4. C# enumと数値の変換

4-1. enumをintに変換する方法

enumをintに変換するには、キャストを使います。

C#
OrderStatus status = OrderStatus.Completed;

int value = (int)status;

Console.WriteLine(value);

たとえば、次のようなenumがあるとします。

C#
public enum OrderStatus
{
    Pending = 0,
    Processing = 1,
    Completed = 2,
    Canceled = 3
}

この場合、OrderStatus.Completedをintに変換すると2になります。

C#
int value = (int)OrderStatus.Completed;

Console.WriteLine(value); // 2

データベースに数値として保存したい場合や、外部システムと数値コードで連携する場合に使われます。

4-2. intをenumに変換する方法

intをenumに変換する場合もキャストを使います。

C#
int value = 2;

OrderStatus status = (OrderStatus)value;

Console.WriteLine(status); // Completed

数値2がOrderStatus.Completedに対応しているため、表示するとCompletedになります。

ただし、この変換には注意点があります。

4-3. 存在しない数値をenumに変換できてしまう注意点

C#では、enumに定義されていない数値でもキャストできてしまいます。

C#
int value = 999;

OrderStatus status = (OrderStatus)value;

Console.WriteLine(status); // 999

OrderStatusに999という値が定義されていなくても、エラーにはなりません。

これは初心者が特に注意すべきポイントです。

enumを使っているからといって、必ず定義済みの値だけが入るとは限りません。特に、外部入力、データベース、API、ファイルから数値を受け取る場合は、値が有効かどうかを確認する必要があります。

4-4. Enum.IsDefinedで有効な値か確認する

数値がenumに定義されているか確認するには、Enum.IsDefinedを使います。

C#
int value = 2;

if (Enum.IsDefined(typeof(OrderStatus), value))
{
    OrderStatus status = (OrderStatus)value;
    Console.WriteLine(status);
}
else
{
    Console.WriteLine("無効な値です");
}

ジェネリック版を使える環境では、次のようにも書けます。

C#
int value = 2;

if (Enum.IsDefined<OrderStatus>((OrderStatus)value))
{
    OrderStatus status = (OrderStatus)value;
    Console.WriteLine(status);
}
else
{
    Console.WriteLine("無効な値です");
}

外部から受け取った数値をenumに変換する場合は、変換前または変換後に有効性を確認するのが安全です。

4-5. 数値変換を使うべき場面と避けるべき場面

enumと数値の変換は便利ですが、むやみに使うべきではありません。

使うべき場面としては、次のようなケースがあります。

データベースに数値として保存する場合。

C#
int dbValue = (int)OrderStatus.Completed;

外部APIの仕様で数値コードが決まっている場合。

C#
OrderStatus status = (OrderStatus)apiStatusCode;

ログやファイルに数値として記録する必要がある場合。

一方、通常の業務ロジックでは、できるだけenumの名前で扱うほうが安全です。

C#
if (status == OrderStatus.Completed)
{
    Console.WriteLine("完了処理を行います");
}

次のように数値で比較するのは避けたほうがよいです。

C#
if ((int)status == 2)
{
    Console.WriteLine("完了処理を行います");
}

この書き方では、2の意味が分かりにくくなります。

5. C# enumと文字列の変換

5-1. enumを文字列に変換する方法

enumを文字列に変換するには、ToString()を使います。

C#
OrderStatus status = OrderStatus.Completed;

string text = status.ToString();

Console.WriteLine(text); // Completed

文字列補間でも自動的に文字列として扱われます。

C#
Console.WriteLine($"現在の状態は {status} です");

この場合、出力は次のようになります。

C#
現在の状態は Completed です

ただし、ToString()で得られる文字列は、enumのメンバー名です。画面に表示する日本語名とは別に考える必要があります。

5-2. 文字列をenumに変換するEnum.Parseの使い方

文字列をenumに変換するには、Enum.Parseを使います。

C#
string text = "Completed";

OrderStatus status = (OrderStatus)Enum.Parse(typeof(OrderStatus), text);

Console.WriteLine(status); // Completed

ジェネリック版を使うと、より簡潔に書けます。

C#
string text = "Completed";

OrderStatus status = Enum.Parse<OrderStatus>(text);

Console.WriteLine(status); // Completed

ただし、Enum.Parseは変換できない文字列を渡すと例外が発生します。

C#
string text = "Complete";

OrderStatus status = Enum.Parse<OrderStatus>(text); // 例外

ユーザー入力や外部データを扱う場合は、Enum.ParseよりもEnum.TryParseを使うほうが安全です。

5-3. 例外を避けるEnum.TryParseの使い方

Enum.TryParseを使うと、変換に成功したかどうかをboolで判定できます。

C#
string text = "Completed";

if (Enum.TryParse<OrderStatus>(text, out OrderStatus status))
{
    Console.WriteLine($"変換成功: {status}");
}
else
{
    Console.WriteLine("変換できませんでした");
}

Enum.TryParseは、変換できない場合でも例外を発生させません。

C#
string text = "Complete";

if (Enum.TryParse<OrderStatus>(text, out OrderStatus status))
{
    Console.WriteLine(status);
}
else
{
    Console.WriteLine("無効な文字列です");
}

ユーザーが入力した文字列、CSVファイル、JSON、APIレスポンスなどをenumに変換する場合は、TryParseを使うのが基本です。

5-4. 大文字・小文字を無視して変換する方法

Enum.TryParseでは、大文字・小文字を無視して変換できます。

C#
string text = "completed";

if (Enum.TryParse<OrderStatus>(text, ignoreCase: true, out OrderStatus status))
{
    Console.WriteLine(status); // Completed
}
else
{
    Console.WriteLine("変換できませんでした");
}

ignoreCase: trueを指定すると、"Completed"、"completed"、"COMPLETED"などを同じように扱えます。

C#
Enum.TryParse<OrderStatus>("COMPLETED", true, out OrderStatus status);

外部入力では大文字・小文字が統一されていないこともあるため、必要に応じてignoreCaseを使うと便利です。

5-5. 日本語表示名や画面表示用の文字列を扱う方法

enumのメンバー名は英語で定義することが多いですが、画面には日本語で表示したい場合があります。

たとえば、次のようなenumがあるとします。

C#
public enum OrderStatus
{
    Pending,
    Processing,
    Completed,
    Canceled
}

画面には「受付中」「処理中」「完了」「キャンセル」と表示したい場合、switch式で変換する方法があります。

C#
public static string ToDisplayName(OrderStatus status)
{
    return status switch
    {
        OrderStatus.Pending => "受付中",
        OrderStatus.Processing => "処理中",
        OrderStatus.Completed => "完了",
        OrderStatus.Canceled => "キャンセル",
        _ => "不明"
    };
}

使い方は次のとおりです。

C#
OrderStatus status = OrderStatus.Completed;

Console.WriteLine(ToDisplayName(status)); // 完了

属性を使って表示名を持たせる方法もあります。

C#
using System.ComponentModel.DataAnnotations;

public enum OrderStatus
{
    [Display(Name = "受付中")]
    Pending,

    [Display(Name = "処理中")]
    Processing,

    [Display(Name = "完了")]
    Completed,

    [Display(Name = "キャンセル")]
    Canceled
}

ただし、属性から値を取り出すにはリフレクションが必要になります。初心者のうちは、まずswitch式や辞書を使った変換から始めると分かりやすいです。

6. C# enumの一覧取得とループ処理

6-1. Enum.GetValuesでenumの値一覧を取得する

Enum.GetValuesを使うと、enumに定義されている値の一覧を取得できます。

C#
foreach (OrderStatus status in Enum.GetValues(typeof(OrderStatus)))
{
    Console.WriteLine(status);
}

出力例は次のようになります。

C#
Pending
Processing
Completed
Canceled

ジェネリック版を使える環境では、次のように書けます。

C#
foreach (OrderStatus status in Enum.GetValues<OrderStatus>())
{
    Console.WriteLine(status);
}

Enum.GetValuesは、画面の選択肢を作るときや、全てのenum値に対して処理をしたいときに便利です。

6-2. Enum.GetNamesでenum名の一覧を取得する

Enum.GetNamesを使うと、enumのメンバー名を文字列の配列として取得できます。

C#
string[] names = Enum.GetNames(typeof(OrderStatus));

foreach (string name in names)
{
    Console.WriteLine(name);
}

出力例は次のとおりです。

C#
Pending
Processing
Completed
Canceled

ジェネリック版では次のように書けます。

C#
string[] names = Enum.GetNames<OrderStatus>();

Enum.GetValuesはenumの値を取得し、Enum.GetNamesは名前の文字列を取得する、という違いがあります。

6-3. foreachでenumを順番に処理する

Enum.GetValuesとforeachを組み合わせると、enumの各値を順番に処理できます。

C#
foreach (OrderStatus status in Enum.GetValues<OrderStatus>())
{
    string displayName = status switch
    {
        OrderStatus.Pending => "受付中",
        OrderStatus.Processing => "処理中",
        OrderStatus.Completed => "完了",
        OrderStatus.Canceled => "キャンセル",
        _ => "不明"
    };

    Console.WriteLine($"{status}: {displayName}");
}

出力例は次のようになります。

C#
Pending: 受付中
Processing: 処理中
Completed: 完了
Canceled: キャンセル

この方法は、マスターデータのような簡単な選択肢を生成するときに便利です。

6-4. ドロップダウンや選択肢生成にenumを使う例

Webアプリやデスクトップアプリでは、enumからドロップダウンの選択肢を作ることがあります。

たとえば、次のような選択肢用クラスを用意します。

C#
public class SelectOption
{
    public int Value { get; set; }
    public string Text { get; set; } = "";
}

enumから選択肢を作る処理は次のように書けます。

C#
List<SelectOption> options = Enum.GetValues<OrderStatus>()
    .Select(status => new SelectOption
    {
        Value = (int)status,
        Text = ToDisplayName(status)
    })
    .ToList();

表示名を返すメソッドは次のように用意します。

C#
public static string ToDisplayName(OrderStatus status)
{
    return status switch
    {
        OrderStatus.Pending => "受付中",
        OrderStatus.Processing => "処理中",
        OrderStatus.Completed => "完了",
        OrderStatus.Canceled => "キャンセル",
        _ => "不明"
    };
}

これにより、enumの定義を元に選択肢を生成できます。

6-5. enum一覧取得時の型変換の注意点

古い書き方では、Enum.GetValues(typeof(OrderStatus))の戻り値は配列として扱われるため、foreachで型を明示する必要があります。

C#
foreach (OrderStatus status in Enum.GetValues(typeof(OrderStatus)))
{
    Console.WriteLine(status);
}

ジェネリック版を使える場合は、こちらのほうが型安全です。

C#
foreach (OrderStatus status in Enum.GetValues<OrderStatus>())
{
    Console.WriteLine(status);
}

また、enumに同じ数値を持つメンバーを定義している場合、一覧取得や文字列変換で思わぬ結果になることがあります。

C#
public enum SampleStatus
{
    None = 0,
    Unknown = 0,
    Active = 1
}

このような定義は意図が明確でない限り避けたほうがよいです。

7. C# enumの比較方法

7-1. enum同士を==で比較する

enum同士は==で比較できます。

C#
OrderStatus status = OrderStatus.Completed;

if (status == OrderStatus.Completed)
{
    Console.WriteLine("完了しています");
}

一致しないことを確認する場合は!=を使います。

C#
if (status != OrderStatus.Canceled)
{
    Console.WriteLine("キャンセルされていません");
}

enumは値型なので、同じenum型同士であればシンプルに比較できます。

7-2. enumと数値を比較するときの注意点

enumと数値を比較したい場合、キャストすれば比較できます。

C#
OrderStatus status = OrderStatus.Completed;

if ((int)status == 2)
{
    Console.WriteLine("完了です");
}

しかし、この書き方はおすすめできません。

2が何を意味するのか分かりにくくなるためです。

次のようにenumの名前で比較するほうが読みやすくなります。

C#
if (status == OrderStatus.Completed)
{
    Console.WriteLine("完了です");
}

数値比較が必要になるのは、データベースや外部APIと連携する場面などに限定したほうがよいです。

7-3. enumの大小比較はできるのか

enumは内部的には数値を持っているため、キャストすれば大小比較できます。

C#
OrderStatus status = OrderStatus.Processing;

if ((int)status > (int)OrderStatus.Pending)
{
    Console.WriteLine("受付後の状態です");
}

ただし、enumの順番や数値に業務的な意味があるとは限りません。

たとえば、次のような定義では大小比較に意味があるかもしれません。

C#
public enum Priority
{
    Low = 1,
    Medium = 2,
    High = 3
}

この場合、HighはMediumより優先度が高いと考えられます。

C#
if (Priority.High > Priority.Medium)
{
    Console.WriteLine("Highのほうが優先度が高いです");
}

ただし、状態を表すenumでは、大小比較よりも明示的な条件分岐のほうが安全です。

C#
if (status == OrderStatus.Completed)
{
    Console.WriteLine("完了処理を行います");
}

7-4. nullable enumを比較する方法

enumは値型なので、通常はnullを代入できません。

C#
OrderStatus status = null; // エラー

nullを許可したい場合は、nullable enumを使います。

C#
OrderStatus? status = null;

値があるかどうかを確認するには、HasValueを使います。

C#
if (status.HasValue)
{
    Console.WriteLine(status.Value);
}
else
{
    Console.WriteLine("状態が未設定です");
}

特定の値と比較する場合は、そのまま比較できます。

C#
if (status == OrderStatus.Completed)
{
    Console.WriteLine("完了しています");
}

statusがnullの場合、この条件はfalseになります。

未設定を表すためにnullable enumを使うこともできますが、多くの場合はUnknownやNoneを定義するほうが扱いやすいです。

C#
public enum OrderStatus
{
    Unknown = 0,
    Pending = 1,
    Processing = 2,
    Completed = 3,
    Canceled = 4
}

7-5. 比較処理で起きやすいミスと対策

enumの比較でよくあるミスは、数値で比較してしまうことです。

C#
if ((int)status == 3)
{
    Console.WriteLine("完了");
}

このコードは、後からenumの数値が変わったときに壊れやすくなります。

対策として、必ず名前で比較します。

C#
if (status == OrderStatus.Completed)
{
    Console.WriteLine("完了");
}

もう1つのミスは、外部から受け取った数値を検証せずに使うことです。

C#
OrderStatus status = (OrderStatus)999;

このような値が入ると、switch文で想定外の動作をする可能性があります。

対策として、Enum.IsDefinedで検証します。

C#
if (!Enum.IsDefined<OrderStatus>(status))
{
    throw new ArgumentException("無効な注文状態です");
}

また、新しいenum値を追加したのに、比較処理やswitch文に反映し忘れることもあります。switch式で_を使う場合でも、ログを出すなどして想定外の値に気づけるようにしておくと安全です。

8. C# enumのFlags属性とビット演算

8-1. Flags属性とは？複数の値を組み合わせる仕組み

通常のenumは、基本的に1つの値を選ぶために使います。

C#
UserRole role = UserRole.Admin;

一方で、複数の選択肢を組み合わせたい場合があります。

たとえば、ユーザー権限として「読み取り」「書き込み」「削除」を組み合わせたい場合です。

このようなときに使うのがFlags属性です。

C#
[Flags]
public enum Permissions
{
    None = 0,
    Read = 1,
    Write = 2,
    Delete = 4
}

Flags属性を付けることで、複数の値をビット演算で組み合わせる意図を明確にできます。

C#
Permissions permissions = Permissions.Read | Permissions.Write;

この例では、ReadとWriteの権限を同時に持つことを表しています。

8-2. Flags enumの定義方法

Flags enumは、enumの上に[Flags]属性を付けて定義します。

C#
[Flags]
public enum Permissions
{
    None = 0,
    Read = 1,
    Write = 2,
    Delete = 4,
    Execute = 8
}

None = 0は、何の権限も持っていない状態を表します。

C#
Permissions permissions = Permissions.None;

複数の権限を組み合わせる場合は、OR演算子|を使います。

C#
Permissions permissions = Permissions.Read | Permissions.Write;

Flags属性を付けておくと、ToString()したときにも分かりやすく表示されます。

C#
Console.WriteLine(permissions); // Read, Write

8-3. 値を1, 2, 4, 8のように定義する理由

Flags enumでは、値を1, 2, 4, 8のように定義します。

これは、それぞれの値を2進数で見たときに、異なるビットを表すためです。

C#
Read    = 1  // 0001
Write   = 2  // 0010
Delete  = 4  // 0100
Execute = 8  // 1000

このように定義することで、複数の値を重ならずに組み合わせることができます。

たとえば、Read | Writeは次のようになります。

C#
0001
0010
----
0011

結果は3ですが、ビットを見るとReadとWriteを持っていることが分かります。

もし、次のように連番で定義してしまうと問題が起きます。

C#
[Flags]
public enum BadPermissions
{
    None = 0,
    Read = 1,
    Write = 2,
    Delete = 3
}

Delete = 3は2進数では0011なので、Read | Writeと同じ値になってしまいます。これでは正しく判定できません。

そのため、Flags enumでは必ず1, 2, 4, 8, 16のように2の累乗で定義します。

8-4. 複数のフラグをORで組み合わせる

複数のフラグを組み合わせるには、OR演算子|を使います。

C#
Permissions permissions = Permissions.Read | Permissions.Write;

この変数は、読み取り権限と書き込み権限を持っている状態です。

さらに権限を追加することもできます。

C#
permissions = permissions | Permissions.Delete;

短く書くと次のようになります。

C#
permissions |= Permissions.Delete;

これで、Read、Write、Deleteの3つの権限を持つ状態になります。

C#
Console.WriteLine(permissions); // Read, Write, Delete

よく使う組み合わせを定義しておくこともできます。

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

このようにすると、全権限を簡単に指定できます。

C#
Permissions permissions = Permissions.All;

8-5. HasFlagでフラグを持っているか判定する

特定のフラグを持っているか確認するには、HasFlagを使えます。

C#
Permissions permissions = Permissions.Read | Permissions.Write;

if (permissions.HasFlag(Permissions.Read))
{
    Console.WriteLine("読み取り権限があります");
}

Writeを持っているか確認する場合は次のようにします。

C#
if (permissions.HasFlag(Permissions.Write))
{
    Console.WriteLine("書き込み権限があります");
}

持っていない権限の場合はfalseになります。

C#
if (permissions.HasFlag(Permissions.Delete))
{
    Console.WriteLine("削除権限があります");
}
else
{
    Console.WriteLine("削除権限はありません");
}

HasFlagは読みやすいため、初心者にも分かりやすい方法です。

8-6. AND・OR・NOTを使ったフラグ操作

Flags enumでは、ビット演算を使ってフラグを操作できます。

フラグを追加するにはOR演算子|を使います。

C#
permissions |= Permissions.Delete;

フラグを持っているか確認するにはAND演算子&を使います。

C#
if ((permissions & Permissions.Read) == Permissions.Read)
{
    Console.WriteLine("読み取り権限があります");
}

フラグを削除するには、AND演算子&とNOT演算子~を組み合わせます。

C#
permissions &= ~Permissions.Write;

これは「Write以外を残す」という意味です。

C#
Permissions permissions = Permissions.Read | Permissions.Write | Permissions.Delete;

permissions &= ~Permissions.Write;

Console.WriteLine(permissions); // Read, Delete

フラグを反転させる場合にも~を使いますが、意図しないビットまで立つことがあるため、扱いには注意が必要です。

8-7. Flagsを使うべき場面と使わないほうがよい場面

Flagsを使うべきなのは、複数の値を同時に持つことが自然な場合です。

たとえば、ユーザー権限はFlagsに向いています。

C#
Permissions permissions = Permissions.Read | Permissions.Write;

ファイル属性のように、複数の属性を同時に持つものも向いています。

一方、注文状態のように、基本的に1つの状態しか持たないものにはFlagsを使うべきではありません。

C#
OrderStatus status = OrderStatus.Pending;

注文が「受付中」でありながら同時に「完了」でもある、という状態は通常は不自然です。

このような場合は、通常のenumを使います。

C#
public enum OrderStatus
{
    Pending,
    Processing,
    Completed,
    Canceled
}