C#怎么使用枚举_C#定义和使用枚举类型教程【教程】-C#.Net教程-PHP中文网

c#枚举需显式设0值成员以防非法值，组合用[flags]且2的幂赋值，扩展方法封装逻辑，反序列化须手动校验合法性。

c#怎么使用枚举_c#定义和使用枚举类型教程【教程】

直接用 enum 声明，然后当类型用就行；但不验证值合法性、不处理位组合、不加扩展方法，就只是“能跑”，不是“写对了”。

声明枚举时为什么必须显式设 0 值成员

因为 C# 允许隐式把 0 赋给任意枚举变量，哪怕它根本不在枚举列表里。比如：

enum GpioPort { GpioA = 1, GpioB, GpioC }
GpioPort p = (GpioPort)0; // 编译通过，但 p.ToString() 输出 "0"，不是有效名称

这会导致 Enum.IsDefined(typeof(GpioPort), p) 返回 false，后续序列化、日志、UI 显示都可能出错。

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

始终让第一个成员值为 0（如 None = 0、Unknown = 0）
若业务上真没有“无值”语义，也要加一个占位的 Invalid = 0 并文档说明
基础类型选 byte 或 short 时更要小心：enum E : byte { A = 255 } 后再写 E.B 就会溢出

需要多选组合时必须加 `[Flags]` 特性

没加 [Flags] 的枚举调用 .ToString() 或传给调试器时，只会显示数字或单个名称；加了之后才能正确解析位或结果：

[Flags]
public enum Permission { None = 0, Read = 1, Write = 2, Execute = 4 }
var p = Permission.Read | Permission.Write; // 值为 3
Console.WriteLine(p); // 输出 "Read, Write"，而不是 "3"

必须用 2 的幂赋值（1, 2, 4, 8...），或用左移（Read = 1 ）保证不重叠
HasFlag() 性能较差，推荐用位与判断：(p & Permission.Read) == Permission.Read
JSON 序列化默认输出数字，要用 JsonSerializerOptions.Converters.Add(new JsonStringEnumConverter()) 才转成字符串

给枚举加方法只能靠扩展类，不能写在 enum 里

C# 枚举本身不能定义方法、属性或构造函数，所有逻辑封装都得走 static class 扩展：

public enum Status { Pending, Running, Done }
public static class StatusExtensions {
    public static bool IsTerminal(this Status s) => s == Status.Done;
    public static string ToDisplayName(this Status s) => s switch {
        Status.Pending => "等待中",
        Status.Running => "运行中",
        Status.Done => "已完成",
        _ => "未知"
    };
}