如何在 C# 中列舉一個列舉值
Payel Ganguly
2023年1月30日
2020年10月15日
本教程介紹瞭如何在 C# 中列舉一個列舉型別，並通過一些程式碼例項列表進行演示。
在上一篇教程中，我們已經學習瞭如何使用 C# 從 enum 中檢索 int 值。在上一篇教程中提到，Enumeration 或 enum 是一種使用者定義的值型別，它定義了一組底層整數型別的命名常量。
我們知道，enum 的常用語法如下。
enum <enum_name> {
enumeration_list
};
enum_name 指定列舉型別的名稱，enumeration_list 指定逗號分隔的識別符號列表。
接下來，我們將看到如何在 C# 中迴圈或列舉所有 enum 值。有幾種方法可以列舉一個 enum。下面的例子將說明這些方法。
Enum.GetNames() 方法來列舉 enum
目的是使用 Enum.GetName() 方法獲得列舉列表中常量的名稱陣列。它使用 foreach 迴圈列印名稱陣列。
using System;
public class Example1
{
public enum Fruits
{
Apple,
Banana,
Orange,
Watermelon,
Mango,
Strawberry
}
public static void Main()
{
foreach (string fruit in Enum.GetNames(typeof(Fruits)))
{
Console.WriteLine(fruit);
}
}
}
輸出：
Apple
Banana
Orange
Watermelon
Mango
Strawberry
Enum.GetValues() 方法在 C# 中列舉 enum
另一種方法是使用 Enum.GetValues() 方法，該方法檢索列舉列表中的常量值陣列。它還使用 foreach 迴圈列印每個值。
using System;
public class Example2
{
public enum Subjects
{
Maths,
Biology,
English,
Chemistry,
Physics,
History
}
public static void Main()
{
foreach (Subjects sub in Enum.GetValues(typeof(Subjects)))
{
Console.WriteLine(sub);
}
}
}
輸出：
Maths
Biology
English
Chemistry
Physics
History
讓我們討論一些更多的例子來了解如何使用 Enum.GetValues() 方法。
更多的例子
例 1:
using System;
public class Demo1
{
enum Colors { White, Black, Red, Green, Blue };
enum Planets { Earth = 0, Jupiter = 10, Saturn = 20, Mars = 30, Venus = 40 };
public static void Main() {
Console.WriteLine("The list of Colors Enum are:");
foreach(int i in Enum.GetValues(typeof(Colors)))
Console.WriteLine(i);
Console.WriteLine();
Console.WriteLine("The list of Planets Enum are:");
foreach(int i in Enum.GetValues(typeof(Planets)))
Console.WriteLine(i);
}
}
輸出：
The list of Colors Enum are:
0
1
2
3
4
The list of Planets Enum are:
0
10
20
30
40
在上面例子的第一部分，陣列元素按照列舉常量的二進位制值（即無符號值）進行排序。
例 2：
using System;
enum SignValue { NegativeVal = -1, ZeroVal = 0, PositiveVal = 1 };
public class MainValue
{
public static void Main()
{
foreach (var val in Enum.GetValues(typeof(SignValue))) {
Console.WriteLine("{0,3} 0X{0:X8} {1}", (int)val, ((SignValue)val));
}
}
}
輸出：
0 ZeroVal 0X00000000
1 PositiveVal 0X00000001
-1 NegativeVal 0XFFFFFFFF
上面的例子顯示了 Enum.GetValues() 方法為列舉列表返回的陣列資訊，其中包括零值、負值和正值。
備註
Enum.GetValues() 方法返回一個陣列，該陣列包含 enum 中每個元素的值。如果多個元素具有相同的值，則生成的陣列包括重複的值。在這種情況下，用返回陣列中的每個值呼叫 Enum.GetNames() 方法不會恢復分配給具有重複值的元素的唯一名稱。為了成功檢索所有列舉成員的名稱，我們建議呼叫 Enum.GetNames() 方法。