如何为枚举类型添加说明

枚举类型大家在平时程序中经常会用到，先看下面的列子

enum Orientation
        {
            East,
            South,
            West,
            North
        }

上面代码定义了一个方向的枚举类型，包括东、南、西、北四个值，这样似乎也没有问题，但是我们是中国人，有时候看中文会更加习惯一些，更重要的是在做数据显示的时候，利用Enum.GetNames方法也只能获得像“North”这样的英文，而得不到理想中的“北”。这种情况，尤其是在数据绑定的时候将十分的麻烦，还需要另外写代码将“东、南、西、北”的字符定义出来，再与具体的枚举值关联起来。

为了解决这个问题，可以直接将值的字符串定义成中文，如下所示。

enum Orientation
        {
            东,
            南,
            西,
            北
        }

这样，通过Enum.GetNames方法就可以获得“东、南、西、北”这样的字符了。但是这样的编码也太违背编码习惯了，毕竟中文字符变量让人看起来十分的别扭。如何解决这个问题呢？答案就是使用Attribute！下面就是示例代码。

enum Orientation
        {
            [DescriptionAttribute("东")]
            East,
            [DescriptionAttribute("南")]
            South,
            [DescriptionAttribute("西")]
            West,
            [DescriptionAttribute("北")]
            North
        }

但又如何获取DescriptionAttribute的内容呢？呵呵，答案就是通过反射。下面是我封装获取DescriptionAttribute内容的扩展方法。

static string GetDescription<T>(this T value)
        {
            var memInfo = value.GetType().GetMember(value.ToString());
            var attributes = memInfo[0].GetCustomAttributes(typeof(DescriptionAttribute), false).Cast<DescriptionAttribute>();
            if (attributes.Any())
                return attributes.First().Description;
            return string.Empty;
        }

下面就是测试的代码以及测试结果

static class Program
    {
        enum Orientation
        {
            [DescriptionAttribute("东")]
            East,
            [DescriptionAttribute("南")]
            South,
            [DescriptionAttribute("西")]
            West,
            [DescriptionAttribute("北")]
            North
        }
        static string GetDescription<T>(this T value)
        {
            var memInfo = value.GetType().GetMember(value.ToString());
            var attributes = memInfo[0].GetCustomAttributes(typeof(DescriptionAttribute), false).Cast<DescriptionAttribute>();
            if (attributes.Any())
                return attributes.First().Description;
            return string.Empty;
        }
        static void Main()
        {
            foreach (var s in Enum.GetValues(typeof(Orientation)))
            {
                Console.WriteLine("值：{0}		说明：{1}",s.ToString(),s.GetDescription());
            }
        }        
    }

从输出可以看出，程序成功的获取了枚举值的说明内容，这样就可以利用这种模式方便的对枚举值添加中文说明，然后在需要的时候提取出来，如：需要做数据绑定的时候。