枚举可转换为字符串或整数,用于显示、存储或传输。使用 ToString() 获取名称,结合 DescriptionAttribute 与反射获取中文描述;通过强制类型转换转为整数;用 Enum.TryParse 从字符串安全解析,Enum.ToObject 从整数还原枚举。注意值范围、名称匹配及性能优化。

在 .NET 中,枚举(Enum)是一种值类型,用于定义一组命名的常量。实际开发中,经常需要将枚举转换为字符串或整数,以便于显示、存储或传输。本文详细介绍如何进行这些转换,并提供实用示例。
将枚举转换为字符串
将枚举转换为字符串是最常见的操作之一,通常用于界面显示或日志记录。
- 使用 ToString() 方法:直接调用枚举实例的 ToString() 方法,返回其名称字符串。
示例:
enum Color { Red, Green, Blue }
Color color = Color.Red;
string colorName = color.ToString(); // 结果:"Red"
- 获取描述性文本(使用 DescriptionAttribute):若希望显示更友好的名称,可以结合 DescriptionAttribute 和反射实现。
示例:
using System.ComponentModel;
enum Status
{
[Description("待处理")]
Pending,
[Description("已完成")]
Completed
}
// 获取描述文本的辅助方法
public static string GetDescription(Enum value)
{
var field = value.GetType().GetField(value.ToString());
var attribute = (DescriptionAttribute)Attribute.GetCustomAttribute(
field, typeof(DescriptionAttribute));
return attribute?.Description ?? value.ToString();
}
// 使用
Status status = Status.Completed;
string desc = GetDescription(status); // 结果:"已完成"
将枚举转换为整数
枚举底层基于整型(默认为 int),因此可直接强制转换为整数类型。
- 使用强制类型转换:将枚举变量直接转为 int 或其他整型。
示例:
enum Priority { Low = 1, Medium = 2, High = 3 }
Priority priority = Priority.Medium;
int priorityValue = (int)priority; // 结果:2
- 适用于所有整型:也可转换为 long、byte 等,只要值在目标类型范围内。
示例:
byte byteValue = (byte)Priority.Low; // 结果:1 long longValue = (long)Priority.High; // 结果:3
从字符串或整数解析回枚举
除了输出转换,有时也需要将外部输入(如用户输入、数据库值)还原为枚举类型。
- 从字符串解析:Enum.Parse 或 Enum.TryParse
示例:
string input = "Green";
if (Enum.TryParse(input, out Color parsedColor))
{
// 成功解析:parsedColor 为 Color.Green
}
else
{
// 解析失败
}
- 忽略大小写解析:可传入 true 表示忽略大小写。
Enum.TryParse("red", true, out Color c); // 成功匹配
- 从整数解析:Enum.ToObject
示例:
int value = 2; Priority p = (Priority)Enum.ToObject(typeof(Priority), value); // 结果:Priority.Medium
注意事项与最佳实践
在进行枚举转换时,注意以下几点以避免常见问题:
- 确保字符串名称与枚举项完全匹配(或使用 TryParse 安全处理)。
- 整数转换时,确认数值在枚举定义范围内,否则可能产生无效值。
- 使用 [Flags] 特性的枚举表示位域,ToString() 会尝试组合名称,如 "Read, Write"。
- 频繁使用描述属性时,建议缓存反射结果以提升性能。
基本上就这些。掌握枚举与字符串、整数之间的转换方法,能让你在数据处理、API 接口、配置解析等场景中更加得心应手。









