次の方法で共有

列挙型 (C# リファレンス)

列挙型 (または列挙型) は、基になる整数数値型の名前付き定数のセットによって定義される値型です。 列挙型を定義するには、 enum キーワードを使用し、 列挙型メンバーの名前を指定します。

enum Season
{
    Spring,
    Summer,
    Autumn,
    Winter
}

既定では、列挙型メンバーの関連付けられている定数値は int型です。0 から始まり、定義テキストの順序に従って 1 ずつ増加します。 その他の 整数数値 型は、列挙型の基になる型として明示的に指定できます。 次の例に示すように、関連付けられている定数値を明示的に指定することもできます。

enum ErrorCode : ushort
{
    None = 0,
    Unknown = 1,
    ConnectionLost = 100,
    OutlierReading = 200
}

列挙型の定義内でメソッドを定義することはできません。 列挙型に機能を追加するには、 拡張メソッドを作成します。

E列挙型の既定値は、0 に対応する列挙型メンバーがない場合でも、式(E)0によって生成される値です。

列挙型を使用して、相互に排他的な値のセットまたは選択肢の組み合わせから選択を表します。 選択肢の組み合わせを表すには、列挙型をビット フラグとして定義します。

ビット フラグとしての列挙型

列挙型で選択肢の組み合わせを表す場合は、個々の選択肢がビット フィールドになるように、それらの選択肢の列挙型メンバーを定義します。 つまり、これらの列挙型メンバーの関連する値は、2 の累乗である必要があります。 次に、 ビットごとの論理演算子 | または & を使用して、選択肢を組み合わせたり、選択肢の組み合わせを交差させたりすることができます。 列挙型がビット フィールドを宣言することを示すには、 Flags 属性を適用します。 次の例に示すように、列挙型の定義に一般的な組み合わせを含めることもできます。

[Flags]
public enum Days
{
    None      = 0b_0000_0000,  // 0
    Monday    = 0b_0000_0001,  // 1
    Tuesday   = 0b_0000_0010,  // 2
    Wednesday = 0b_0000_0100,  // 4
    Thursday  = 0b_0000_1000,  // 8
    Friday    = 0b_0001_0000,  // 16
    Saturday  = 0b_0010_0000,  // 32
    Sunday    = 0b_0100_0000,  // 64
    Weekend   = Saturday | Sunday
}

public class FlagsEnumExample
{
    public static void Main()
    {
        Days meetingDays = Days.Monday | Days.Wednesday | Days.Friday;
        Console.WriteLine(meetingDays);
        // Output:
        // Monday, Wednesday, Friday

        Days workingFromHomeDays = Days.Thursday | Days.Friday;
        Console.WriteLine($"Join a meeting by phone on {meetingDays & workingFromHomeDays}");
        // Output:
        // Join a meeting by phone on Friday

        bool isMeetingOnTuesday = (meetingDays & Days.Tuesday) == Days.Tuesday;
        Console.WriteLine($"Is there a meeting on Tuesday: {isMeetingOnTuesday}");
        // Output:
        // Is there a meeting on Tuesday: False

        var a = (Days)37;
        Console.WriteLine(a);
        // Output:
        // Monday, Wednesday, Saturday
    }
}

詳細と例については、System.FlagsAttribute API リファレンス ページと、 API リファレンス ページのSystem.Enumセクションを参照してください。

System.Enum 型と列挙型定数

System.Enum型は、すべての列挙型の抽象基底クラスです。 列挙型とその値に関する情報を取得するためのメソッドが多数用意されています。 詳細と例については、 System.Enum API リファレンス ページを参照してください。

基底クラス制約 (列挙型制約と呼ばれます) で System.Enum を使用して、型パラメーターが 列挙型であることを指定できます。 列挙型は、 struct 制約も満たします。これは、型パラメーターが null 非許容値型であることを指定するために使用されます。

コンバージョン

列挙型には、列挙型とその基になる整数型の間に明示的な変換が存在します。 列挙型の値を基になる型に キャスト した場合、結果は列挙型メンバーの関連付けられた整数値になります。

public enum Season
{
    Spring,
    Summer,
    Autumn,
    Winter
}

public class EnumConversionExample
{
    public static void Main()
    {
        Season a = Season.Autumn;
        Console.WriteLine($"Integral value of {a} is {(int)a}");  // output: Integral value of Autumn is 2

        var b = (Season)1;
        Console.WriteLine(b);  // output: Summer

        var c = (Season)4;
        Console.WriteLine(c);  // output: 4
    }
}

Enum.IsDefined メソッドを使用して、列挙型に特定の関連付けられた値を持つ列挙型メンバーが含まれているかどうかを判断します。

どの列挙型にも、型との間でSystem.Enum変換が存在します。

C# 言語仕様

詳細については、「C# 言語仕様」の次のセクションを参照してください。

こちらもご覧ください