.Net Attribute详解(下) - 使用Attribute武装枚举类型
Posted
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了.Net Attribute详解(下) - 使用Attribute武装枚举类型相关的知识,希望对你有一定的参考价值。
接上文.Net Attribute详解(上)-Attribute本质以及一个简单示例,这篇文章介绍一个非常实用的例子,相信你一定能够用到你正在开发的项目中。枚举类型被常常用到项目中,如果要使用枚举ToString方法直接输出字符串, 常常不是我们想要的输出,因为它是安装定义的名称输出字符串。比如你有一个性别枚举,有Man, Woman. 你在中文系统中,在创建用户的页面上,这个枚举代表的下拉框,当然不是显示Man和Woman的,而是要显示”男”和”女“。 下面就介绍如何使用Attribute非常方便的输出我们想要的字符串。
1, 使用System.ComponentModel.DescriptionAttribute
比如,下面这个枚举
enum Gender { Man, Woman };
在使用上DescriptionAttribute后,可以改造成这样
enum Gender { [Description(“男”)] Man, [Description(“女”)] Woman };
好了,使用Attribute的三个步骤:
Attribute的定义, Attribute的使用(贴标签), Attribute的读取和使用(根据标签做不同处理)
第一步,我们使用了系统中的Attribute,贴标签已经做好了,接下来时对于Attribute的读取和使用了。
2, EnumHelper类
下面定义的EnumHelper类,使用扩展方法,为枚举提供了非常方便的方式输出Description. 比如,我们可以这样使用下面的方法,来得到对应项的字符串:
Gender.Man.GetDescription()
上面输出的就会我们想要的”男”, 而不是”Man”.
/// <summary> /// Contains methods for working with <see cref="Enum"/>. /// </summary> public static class EnumHelper { /// <summary> /// Gets the specified enum value‘s description. /// </summary> /// <param name="value">The enum value.</param> /// <returns>The description or <c>null</c> /// if enum value doesn‘t have <see cref="DescriptionAttribute"/>.</returns> public static string GetDescription(this Enum value) { var fieldInfo = value.GetType().GetField(value.ToString()); var attributes = (DescriptionAttribute[])fieldInfo.GetCustomAttributes( typeof(DescriptionAttribute), false); return attributes.Length > 0 ? attributes[0].Description : null; } /// <summary> /// Gets the enum value by description. /// </summary> /// <typeparam name="EnumType">The enum type.</typeparam> /// <param name="description">The description.</param> /// <returns>The enum value.</returns> public static EnumType GetValueByDescription<EnumType>(string description) { var type = typeof(EnumType); if (!type.IsEnum) throw new ArgumentException("This method is destinated for enum types only."); foreach (var enumName in Enum.GetNames(type)) { var enumValue = Enum.Parse(type, enumName); if (description == ((Enum)enumValue).GetDescription()) return (EnumType)enumValue; } throw new ArgumentException("There is no value with this description among specified enum type values."); } }
3. Attribute在MVC中的Razor view engine 中的使用
在Model上我们可以添加上DisplayAttribute, 比如
public class User { [Display(Name = "User Name)] public string Name{get;set;} }
这样在view中使用html.DisplayFor(), 输出的就是User Name。
这里的使用和我们上面的EnumHelper的原理完全相同。
还有关于Model上的验证相关的Attribute, 比如MaxLength.
[MaxLength(100, ErrorMessage = "The max length is 100")] public string Name{get;set;}
把MaxLength加在Name上,它不仅能够作为MVC中的验证,而且会在Entity Framwork中,作为数据检查规则。因为这个属性披上了一个外衣,上面写着“我的最大长度是100”,如果有任何数据有效性检查的类,都会看到这个外衣,同时检查这个属性的长度是否符合要求。
总之,理解了什么是Attribute, 以及原理,对于理解.net中无处不在的,那些加载类上或者属性上的[]东东,一定能够更加容易。