C#中的列舉型別(Enum)介紹

2022-07-13 18:02:52

列舉（Enum）定義

enum關鍵字用於宣告列舉，即一種由一組稱為列舉數列表的命名常陣列成的獨特型別。通常情況下，最好是在名稱空間內直接定義列舉，以便該名稱空間中的所有類都能夠同樣方便地存取它。但是，還可以將列舉巢狀在類或結構中。現在的有些電商網站根據購物的積分用到的，金牌會員，銀牌會員，銅牌會員.

enum MemberLevel
{
    gold,
    silver,
    copper
}

列舉值獲取

一般獲取的時候包括獲取變數和變數值，預設情況下，第一個列舉數的值為 0，後面每個列舉數的值依次遞增 1。直接使用Enum中的靜態方法即可操作.GetValues中獲取的是列舉變數的值，型別是列舉名，之後自動輸出的是列舉名.

string s = Enum.GetName(typeof(MemberLevel), 3);
 Console.WriteLine(s);
 
 Console.WriteLine("MemberLevel中的值:");
 foreach (int i in Enum.GetValues(typeof(MemberLevel)))
     Console.WriteLine(i);
 Console.WriteLine("MemberLevel中的值(注意型別):");
 foreach (MemberLevel i in Enum.GetValues(typeof(MemberLevel)))
     Console.WriteLine(i);
 
 Console.WriteLine("MemberLevel中的變數:");
 foreach (string str in Enum.GetNames(typeof(MemberLevel)))
     Console.WriteLine(str);
 System.Console.Read();

列舉型別

曾經很長的一段時間自己一度以為列舉的值只能是int型別，其實每種列舉型別都有基礎型別，該型別可以是除 char以外的任何整型(重點)。列舉元素的預設基礎型別為 int.准許使用的列舉型別有byte、sbyte、short、ushort、int、uint、long 或 ulong。如果列舉值為long，如下所示:

enum MemberLevel:long
{
    gold = 2147483648L,
    silver=232L,
    copper=10L
}

列舉Flags和Description特性值

可以使用列舉型別定義位標誌，從而使該列舉型別的範例可以儲存列舉數列表中定義的值的任意組合。建立位標誌列舉的方法是應用System.FlagsAttribute特性並適當定義一些值，以便可以對這些值執行AND、OR、NOT和XOR按位元運算。一般情況下如果零值不表示“未設定任何標誌”，則請不要為標誌指定零值.

[Flags]
enum MemberLevel
{
    [Description("二進位制表示為1----0001")]
    gold = 0x1,
    [Description("二進位制表示為4----0010")]
    silver = 0x04,
    [Description("二進位制表示為16----0100")]
    copper = 0x10
}

程式執行如下所示：

// 0001(Gold) and 0100(silver) => 0101(5).
MemberLevel options = MemberLevel.gold | MemberLevel.silver;
Console.WriteLine(options);
Console.WriteLine((int)options);
System.Console.Read();

上面的基本上屬於入門的知識，在專案中通常用到的是在列舉變數上面加上Description，需要顯示的列舉的特性值，列舉的值一般為int在資料庫中佔用空間比較小，列舉的變數用於給資料庫中的欄位賦值，那麼如果要顯示欄位就需要考慮到Descripttion特性，顯示中文名稱，例如一個使用者的的等級在資料中儲存的是1，顯示的時候顯示為金牌使用者，當然也可以使用switch，if..else..去判斷，如果列舉比較多，自己寫的也很不爽.特性這個時候剛發揮作用了，如下所示:

[Description("會員等級")]
enum MemberLevel
{
    [Description("金牌會員")]
    gold =1,
    [Description("銀牌會員")]
    silver = 2,
    [Description("銅牌會員")]
    copper =3
}

首先來寫一個擴充套件，靜態類，靜態方法，this關鍵字，istop主要是用來獲取列舉上面的描述.

public static class EnumHelper
{
    /// <summary>
    /// 返回列舉項的描述資訊。
    /// </summary>
    /// <param name="value">要獲取描述資訊的列舉項。</param>
    /// <returns>列舉想的描述資訊。</returns>
    public static string GetDescription(this Enum value, bool isTop = false)
    {
        Type enumType = value.GetType();
        DescriptionAttribute attr = null;
        if (isTop)
        {
            attr = (DescriptionAttribute)Attribute.GetCustomAttribute(enumType, typeof(DescriptionAttribute));
        }
        else
        {
            // 獲取列舉常數名稱。
            string name = Enum.GetName(enumType, value);
            if (name != null)
            {
                // 獲取列舉欄位。
                FieldInfo fieldInfo = enumType.GetField(name);
                if (fieldInfo != null)
                {
                    // 獲取描述的屬性。
                    attr = Attribute.GetCustomAttribute(fieldInfo,typeof(DescriptionAttribute), false) as DescriptionAttribute;
                }
            }
        }
 
        if (attr != null && !string.IsNullOrEmpty(attr.Description))
            return attr.Description;
        else
            return string.Empty;
 
    }
}

主程式呼叫如下所示：

MemberLevel gold = MemberLevel.gold;
Console.WriteLine(gold.GetDescription());
System.Console.Read();

到此這篇關於C#列舉型別(Enum)的文章就介紹到這了。希望對大家的學習有所幫助，也希望大家多多支援it145.com。

C#中的列舉型別(Enum)介紹

列舉（Enum）定義

列舉值獲取

列舉型別

列舉Flags和Description特性值

熱門文章