所有枚举从 System.Enum（继承自 System.ValueType）继承。 适用于结构的所有规则也适用于枚举。   C# 程序使用 类型声明 创建新类型。 类型声明指定新类型的名称和成员。 用户可定义以下六种 C# 类型：类类型、结构类型、接口类型、枚举类型、委托类型和元组值类型。 还可以声明 record 类型（ record struct 或 record class ）。 记录类型具有编译器合成成员。 记录主要用于存储值，关联行为最少。   一.枚举类型 enum E {...} 格式的用户定义类型。 enum 类型是一种包含已命名常量的独特类型。 每个 enum 类型都有一个基础类型（必须是八种整型类型之一）。 enum 类型的值集与基础类型的值 集相同。

枚举类型定义了一组常数值。以下enum声明了定义不同根蔬菜的常数:

public enum SomeRootVegetable
{
HorseRadish,
Radish,
Turnip
}

 

还可以定义一个 enum 作为标志组合使用。 以下声明为四季声明了一组标志。 可以随意搭配季节组合，包括 All 值（包含所有季节）：

public enum Seasons {
　　None = 0,
　　Summer = 1,
　　Autumn = 2,
　　Winter = 4,
　　Spring = 8,
　　All = Summer | Autumn | Winter | Spring
}

以下示例显示了前面两个枚举的声明：

var turnip = SomeRootVegetable.Turnip; 

var spring = Seasons.Spring; 

var startingOnEquinox = Seasons.Spring | Seasons.Autumn; 

var theYear = Seasons.All;

  foreach 语句可用于枚举任何集合的元素。 以下代码从前一个示例中枚举数组：  

foreach (int item in a) 
{ 
　　Console.WriteLine(item); 
}

可以使用 await foreach 语句来枚举序列：

await foreach (var number in GenerateSequence()) 
{ 
　　Console.WriteLine(number); 
}

枚举器的释放方式取决于 enumerator 类型的特征。 在常规同步情况下， finally 子句扩展为：

finally 
{ 
　　(enumerator as IDisposable)?.Dispose(); 
}

常规异步情况扩展为：

finally 
{ 

if (enumerator is IAsyncDisposable asyncDisposable) 

await asyncDisposable.DisposeAsync(); 
}

但是，如果 enumerator 的类型为已密封类型，并且不存在从类型 enumerator 到 IDisposable 或 IAsyncDisposable 的隐式转换，则 finally 子句扩展为一个空白块：

finally
{

}

如果存在从类型 enumerator 到 IDisposable 的隐式转换，并且 enumerator 是不可为 null 的值类型，则 finally 子句扩展为：

finally 
{ 
    ((IDisposable)enumerator).Dispose(); 
}

二.枚举约束 从 C# 7.3 开始，还可指定 System.Enum 类型作为基类约束。 CLR 始终允许此约束，但 C# 语言不允许。 使用 System.Enum 的泛型提供类型安全的编程，缓存使用 System.Enum 中静态方法的结果。 以下示例查找枚举类型 的所有有效的值，然后生成将这些值映射到其字符串表示形式的字典。

public static Dictionary<int, string> EnumNamedValues<T>() where T : System.Enum 
{ 
　　var result = new Dictionary<int, string>(); 

　　var values = Enum.GetValues(typeof(T)); 

　　foreach (int item in values) 
　　result.Add(item, Enum.GetName(typeof(T), item)); 

　　return result; 
}

Enum.GetValues 和 Enum.GetName 使用反射，这会对性能产生影响。 可调用 EnumNamedValues 来生成可缓存和重 用的集合，而不是重复执行需要反射才能实施的调用。 如以下示例所示，可使用它来创建枚举并生成其值和名称的字典：

enum Rainbow 
{ Red, Orange, Yellow, Green, Blue, Indigo, Violet }

var map = EnumNamedValues<Rainbow>(); 

foreach (var pair in map)
Console.WriteLine($"{pair.Key}:\t{pair.Value}");

枚举类型 是由基础整型数值类型的一组命名常量定义的值类型。 若要定义枚举类型，请使用 enum 关键字并指 定枚举成员 的名称：

enum Season { Spring, Summer, Autumn, Winter }

默认情况下，枚举成员的关联常数值为类型 int ；它们从零开始，并按定义文本顺序递增 1。 可以显式指定任何 其他整数数值类型作为枚举类型的基础类型。 还可以显式指定关联的常数值，如下面的示例所示：

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

不能在枚举类型的定义内定义方法。 若要向枚举类型添加功能，请创建扩展方法。 枚举类型 E 的默认值是由表达式 (E)0 生成的值，即使零没有相应的枚举成员也是如此。 可以使用枚举类型，通过一组互斥值或选项组合来表示选项。 若要表示选项组合，请将枚举类型定义为位标志。   三.转换 对于任何枚举类型，枚举类型与其基础整型类型之间存在显式转换。 如果将枚举值转换为其基础类型，则结果为 枚举成员的关联整数值。  

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 类型的装箱和取消装箱相互转换。   四.枚举值和操作 每个枚举类型都定义了一个不同的类型;显式 枚举转换 () 需要在枚举类型和整型之间进行转换，或在两个枚举类 型之间进行转换。 枚举类型可以采用的值集不受其枚举成员限制。 特别是，枚举的基础类型的任何值都可以转 换为枚举类型，并且是该枚举类型的非重复有效值。 枚举成员具有其包含枚举类型的类型 (除了其他枚举成员初始值设定项中：请参阅 枚举成员) 。 使用关联值在枚 举类型中声明的枚举成员的值 E v 为 (E)v 。 可以在枚举类型的值上使用以下运算符： == 、 != 、、 < 、 > <= 、 >= (枚举比较运算符) 、binary + (加 法运算符) 、二进制 - (减法运算符) 、、 ( ^ & | 枚举逻辑运算符) 、 ( ~ 按位求补运算符) 以及 ++ ( -- 后缀增量和减量运算符以及前缀增量和减量运算符) 。 每个枚举类型都自动派生自类 System.Enum (后者反过来派生自 System.ValueType 和 object ) 。 因此，此类的继 承方法和属性可用于枚举类型的值。   五.枚举逻辑举运算符 每个枚举类型都 E 隐式提供以下预定义的逻辑运算符：

E operator &(E x, E y); E operator |(E x, E y); E operator ^(E x, E y);

计算结果 x op y （其中 x 和 y 是具有基础类型的枚举类型的表达式 E U ）， op 是一个逻辑运算符，与计 算完全相同 (E)((U)x op (U)y) 。 换言之，枚举类型逻辑运算符只对两个操作数的基础类型执行逻辑运算。