C# 获取与解析枚举类型的 DescriptionAttribute

/// <summary>
/// 返回枚举项的描述信息。
/// </summary>
/// <param name="value">要获取描述信息的枚举项。</param>
/// <returns>枚举想的描述信息。</returns>
public static string GetDescription(Enum value)
{
	Type enumType = value.GetType();
	// 获取枚举常数名称。
	string name = Enum.GetName(enumType, value);
	if (name != null)
	{
		// 获取枚举字段。
		FieldInfo fieldInfo = enumType.GetField(name);
		if (fieldInfo != null)
		{
			// 获取描述的属性。
			DescriptionAttribute attr = Attribute.GetCustomAttribute(fieldInfo,
				typeof(DescriptionAttribute), false) as DescriptionAttribute;
			if (attr != null)
			{
				return attr.Description;
			}
		}
	}
	return null;
}

/// <summary>
/// 返回指定枚举值的描述（通过 
/// <see cref="System.ComponentModel.DescriptionAttribute"/> 指定）。
/// 如果没有指定描述，则返回枚举常数的名称，没有找到枚举常数则返回枚举值。
/// </summary>
/// <param name="value">要获取描述的枚举值。</param>
/// <returns>指定枚举值的描述。</returns>
public static string GetDescription(this Enum value)
{
	Type enumType = value.GetType();
	// 寻找枚举值的组合。
	EnumCache cache = GetEnumCache(enumType.TypeHandle);
	ulong valueUL = ToUInt64(value);
	int idx = Array.BinarySearch(cache.Values, valueUL);
	if (idx >= 0)
	{
		// 枚举值已定义，直接返回相应的描述。
		return cache.Descriptions[idx];
	}
	// 不是可组合的枚举，直接返回枚举值得字符串形式。
	if (!cache.HasFlagsAttribute)
	{
		return GetStringValue(enumType, valueUL);
	}
	List<string> list = new List<string>();
	// 从后向前寻找匹配的二进制。
	for (int i = cache.Values.Length - 1; i >= 0 && valueUL != 0UL; i--)
	{
		ulong enumValue = cache.Values[i];
		if (enumValue == 0UL)
		{
			continue;
		}
		if ((valueUL & enumValue) == enumValue)
		{
			valueUL -= enumValue;
			list.Add(cache.Descriptions[i]);
		}
	}
	list.Reverse();
	// 添加最后剩余的未定义值。
	if (list.Count == 0 || valueUL != 0UL)
	{
		list.Add(GetStringValue(enumType, valueUL));
	}
	return string.Join(", ", list);
}

public static object ParseEx(Type enumType, string value, bool ignoreCase)
{
	ExceptionHelper.CheckArgumentNull(enumType, "enumType");
	ExceptionHelper.CheckArgumentNull(value, "value");
	if (!enumType.IsEnum)
	{
		throw ExceptionHelper.MustBeEnum(enumType);
	}
	value = value.Trim();
	if (value.Length == 0)
	{
		throw ExceptionHelper.MustContainEnumInfo();
	}
	// 尝试对数字进行解析，这样可避免之后的字符串比较。
	char firstChar = value[0];
	ulong tmpValue;
	if (ParseString(value, out tmpValue))
	{
		return Enum.ToObject(enumType, tmpValue);
	}
	// 尝试对描述信息进行解析。
	EnumCache cache = GetEnumCache(enumType.TypeHandle);
	StringComparison comparison = ignoreCase ?
		StringComparison.OrdinalIgnoreCase : StringComparison.Ordinal;
	ulong valueUL = 0;
	int start = 0;
	do
	{
		// 去除前导空白。
		while (char.IsWhiteSpace(value, start)) { start++; }
		int idx = value.IndexOf(‘,‘, start);
		if (idx < 0) { idx = value.Length; }
		int nIdx = idx - 1;
		// 去除后面的空白。
		while (char.IsWhiteSpace(value, nIdx)) { nIdx--; }
		if (nIdx >= start)
		{
			string str = value.Substring(start, nIdx - start + 1);
			int j = 0;
			// 比较常数值的名称和描述信息，先比较名称，后比较描述信息。
			for (; j < cache.Names.Length; j++)
			{
				if (string.Equals(str, cache.Names[j], comparison))
				{
					// 与常数值匹配。
					valueUL |= cache.Values[j];
					break;
				}
			}
			if (j == cache.Names.Length && cache.HasDescription)
			{
				// 比较描述信息。
				for (j = 0; j < cache.Descriptions.Length; j++)
				{
					if (string.Equals(str, cache.Descriptions[j], comparison))
					{
						// 与描述信息匹配。
						valueUL |= cache.Values[j];
						break;
					}
				}
			}
			// 未识别的枚举值。
			if (j == cache.Descriptions.Length)
			{
				// 尝试识别为数字。
				if (ParseString(str, out tmpValue))
				{
					valueUL |= tmpValue;
				}
				else
				{
					// 不能识别为数字。
					throw ExceptionHelper.EnumValueNotFound(enumType, str);
				}
			}
		}
		start = idx + 1;
	} while (start < value.Length);
	return Enum.ToObject(enumType, valueUL);
}

using System;
using System.ComponentModel;
using System.Globalization;

namespace Cyjb.ComponentModel
{
	/// <summary>
	/// 提供将 <see cref="System.Enum"/> 对象与其他各种表示形式相互转换的类型转换器。
	/// 支持枚举值的描述信息。
	/// </summary>
	public class EnumDescConverter : EnumConverter
	{
		/// <summary>
		/// 使用指定类型初始化 <see cref="EnumDescConverter"/> 类的新实例。
		/// </summary>
		/// <param name="type">表示与此转换器关联的枚举类型。</param>
		public EnumDescConverter(Type type)
			: base(type)
		{ }
		/// <summary>
		/// 将指定的值对象转换为枚举对象。
		/// </summary>
		/// <param name="context"><see cref="System.ComponentModel.ITypeDescriptorContext"/>，
		/// 提供格式上下文。</param>
		/// <param name="culture">一个可选的 <see cref="System.Globalization.CultureInfo"/>。
		/// 如果未提供区域性设置，则使用当前区域性。</param>
		/// <param name="value">要转换的 <see cref="System.Object"/>。</param>
		/// <returns>表示转换的 <paramref name="value"/> 的 <see cref="System.Object"/>。</returns>
		public override object ConvertFrom(ITypeDescriptorContext context, CultureInfo culture, object value)
		{
			string strValue = value as string;
			if (strValue != null)
			{
				try
				{
					return EnumExt.ParseEx(this.EnumType, strValue, true);
				}
				catch (Exception ex)
				{
					throw ExceptionHelper.ConvertInvalidValue(value, this.EnumType, ex);
				}
			}
			return base.ConvertFrom(context, culture, value);
		}
		/// <summary>
		/// 将给定的值对象转换为指定的目标类型。
		/// </summary>
		/// <param name="context"><see cref="System.ComponentModel.ITypeDescriptorContext"/>，
		/// 提供格式上下文。</param>
		/// <param name="culture">一个可选的 <see cref="System.Globalization.CultureInfo"/>。
		/// 如果未提供区域性设置，则使用当前区域性。</param>
		/// <param name="value">要转换的 <see cref="System.Object"/>。</param>
		/// <param name="destinationType">要将值转换成的 <see cref="System.Type"/>。</param>
		/// <returns>表示转换的 <paramref name="value"/> 的 <see cref="System.Object"/>。</returns>
		public override object ConvertTo(ITypeDescriptorContext context, CultureInfo culture,
			object value, Type destinationType)
		{
			ExceptionHelper.CheckArgumentNull(destinationType, "destinationType");
			if (value != null && destinationType.TypeHandle.Equals(typeof(string).TypeHandle))
			{
				return EnumExt.GetDescription((Enum)value);
			}
			return base.ConvertTo(context, culture, value, destinationType);
		}
	}
}

public class TestClass
{
	[TypeConverter(typeof(EnumDescConverter))]
	public Tristate Value { get; set; } // 这里的 Tristate 就是一个应用了 DescriptionAttribute 的枚举。
}