C# 列舉型別完整指南：宣告、底層型別、指派值與 Flags 屬性

列舉是什麼？

列舉為一組邏輯相關的整數常數提供具名符號，提升程式可讀性與維護性。

基本宣告

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

關鍵特性

• 列舉變數某一時刻只能持有單一成員值（如 day = WeekDay.Tuesday;）。
• 預設底層型別為 int，首項值 0，後續遞增 1。
• 可自訂底層型別：byte, sbyte, short, ushort, int, uint, long, ulong。
• 可手動指派值：

enum WeekDay : byte {
    Sunday = 1, Monday, Tuesday, Wednesday,
    Thursday, Friday, Saturday
}

列舉 vs 結構

Flags 屬性與位元組合

[Flags]
enum FileAccess {
    Read = 1,    // 0001
    Write = 2,   // 0010
    Execute = 4  // 0100
}
FileAccess access = FileAccess.Read | FileAccess.Write; // 3

常用方法

• Enum.GetNames(typeof(WeekDay))：取得所有成員名稱陣列。
• Enum.GetValues(typeof(WeekDay))：取得所有成員值陣列。
• Enum.TryParse：安全解析字串為列舉值。