更新:2007 年 11 月

枚举类型(也称为枚举)为定义一组可以赋给变量的命名整数常量提供了一种有效的方法。例如,假设您必须定义一个变量,该变量的值表示一周中的一天。该变量只能存储七个有意义的值。若要定义这些值,可以使用枚举类型。枚举类型是使用 enum 关键字声明的。

C# 复制代码
enum Days { Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday };
enum Months : byte { Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec }; 

默认情况下,枚举中每个元素的基础类型是 int。可以使用冒号指定另一种整数值类型,如前面的示例所示。有关可能的类型的完整列表,请参见 enum(C# 参考)

以下是使用枚举而不使用数值类型的好处:

  • 明确为客户端代码指定哪些值是变量的有效值。

  • 在 Visual Studio 中,IntelliSense 列出定义的值。

如果不为枚举数列表中的元素指定值,则它们的值将以 1 为增量自动递增。在前面的示例中,Days.Sunday 的值为 0,Days.Monday 的值为 1,依此类推。创建新的 Days 对象时,如果不显式为其赋值,则它将具有默认值 Days.Sunday (0)。创建枚举时,应选择最合理的默认值并赋给它一个零值。这便使得只要在创建枚举时未为其显式赋值,则所创建的全部枚举都将具有该默认值。

如果变量 meetingDay 的类型为 Days,则只能将 Days 定义的某个值赋给它(无需显式强制转换)。如果会议日期更改,可以将 Days 中的新值赋给 meetingDay

C# 复制代码
Days meetingDay = Days.Monday;
//...
meetingDay = Days.Friday;

说明:

可以将任意整数值赋给 meetingDay。例如,代码行 meetingDay = (Days) 42 不会产生错误。但也不应该这样做,因为默认约定的是枚举变量只容纳枚举定义的值之一。将任意值赋给枚举类型的变量很有可能会导致错误。

可以将任意值赋给枚举类型的枚举数列表中的元素,也可以使用计算值:

C# 复制代码
enum MachineState
{
    PowerOff = 0,
    Running = 5,
    Sleeping = 10,
    Hibernating = Sleeping + 5
}

枚举类型作为位标志

可以使用枚举类型定义位标志,从而使该枚举类型的实例可以存储枚举数列表中定义的值的任意组合。(当然,某些组合在您的程序代码中可能没有意义或不允许使用。)

创建位标志枚举的方法是应用 System..::.FlagsAttribute 属性并适当定义一些值,以便可以对这些值执行 ANDORNOTXOR 按位运算。在位标志枚举中包含一个值为零(表示“未设置任何标志”)的命名常量。如果零值不表示“未设置任何标志”,则请不要为标志指定零值。

在下面的示例中,定义了 Days 枚举的另一个版本,即 Days2Days2 具有 Flags 属性,且它的每个值都是 2 的若干次幂,指数依次递增。这样您就可以创建值为 Days2.TuesdayDays2.ThursdayDays2 变量。

C# 复制代码
[Flags]
enum Days2
{
    None = 0x0,
    Sunday = 0x1,
    Monday = 0x2,
    Tuesday = 0x4,
    Wednesday = 0x8,
    Thursday = 0x10,
    Friday = 0x20,
    Saturday = 0x40
}
class MyClass
{
    Days2 meetingDays = Days2.Tuesday | Days2.Thursday;
}


若要在某个枚举上设置标志,请使用逻辑 OR 运算符,如下面的示例所示:

C# 复制代码
// Initialize with two flags using bitwise OR.
meetingDays = Days2.Tuesday | Days2.Thursday;

// Set an additional flag using bitwise OR.
meetingDays = meetingDays | Days2.Friday;

Console.WriteLine("Meeting days are {0}", meetingDays);
// Output: Meeting days are Tuesday, Thursday, Friday

// Remove a flag using bitwise XOR.
meetingDays = meetingDays ^ Days2.Tuesday;
Console.WriteLine("Meeting days are {0}", meetingDays);
// Output: Meeting days are Thursday, Friday

若要确定是否设置了特定标志,请使用逻辑 AND 运算,如下面的示例所示:

C# 复制代码
// Test value of flags using bitwise AND.
bool test = (meetingDays & Days2.Thursday) == Days2.Thursday;
Console.WriteLine("Thursday {0} a meeting day.", test == true ? "is" : "is not");
// Output: Thursday is a meeting day.

有关使用 System..::.FlagsAttribute 属性定义枚举类型时需要考虑的事项的更多信息,请参见 System..::.Enum

使用 System.Enum 方法发现和操作枚举值

所有枚举都是 System..::.Enum 类型的实例。不能从 System..::.Enum 派生新类,但可以使用它的方法发现有关枚举实例中的值的信息以及操作这些值。

C# 复制代码
string s = Enum.GetName(typeof(Days), 4);
Console.WriteLine(s);

Console.WriteLine("The values of the Days Enum are:");
foreach (int i in Enum.GetValues(typeof(Days)))
    Console.WriteLine(i);

Console.WriteLine("The names of the Days Enum are:");
foreach (string str in Enum.GetNames(typeof(Days)))
    Console.WriteLine(str);

有关更多信息,请参见 System..::.Enum

此外,还可以使用扩展方法为枚举创建新方法。有关更多信息,请参见 如何:为枚举创建新方法(C# 编程指南)

请参见

概念

参考

System..::.Enum

修订记录

日期

修订

原因

2008 年 7 月

新增主题。

内容 Bug 修复