C#使用Enum.TryParse()实现枚举安全转换

今天早睡

发布时间：2026-10-16 | 2人浏览过

原创

在C#开发中，领域模型（Domain）与数据传输对象（DTO/VO）常涉及枚举类型的转换。若一方修改了枚举定义而另一方未同步，直接强转会导致静默失败或逻辑错误。使用 Enum.TryParse 可以安全地验证枚举值是否存在于目标类型中，从而提前拦截非法映射。

问题背景：枚举不同步带来的风险

在典型的分层架构中，后端实体枚举和前端或接口DTO枚举往往独立维护。假设存在两个枚举：

OrderState：领域状态枚举
QueryOrderStatus：查询状态枚举

public enum OrderState
{
    NotActivated,
    Active,
    RequiresReActivation
}

public enum QueryOrderStatus
{
    NotActivated,
    Active,
    RequiresReActivation
}

当两者完全一致时，直接进行强制类型转换通常不会报错：

var queryOrderStatus = (QueryOrderStatus)OrderState.Active;
Console.WriteLine(queryOrderStatus); // 输出: Active

然而，一旦底层枚举新增了一项，例如：

public enum OrderState
{
    NotActivated,
    Active,
    RequiresReActivation,
    Locked  // 新增枚举项
}

此时若仍尝试将新枚举项强转为旧枚举类型：

var queryOrderStatus = (QueryOrderStatus)OrderState.Locked;
Console.WriteLine(queryOrderStatus); // 输出: 3 (即整数索引)

C#允许这种基于整数索引的转换，但 QueryOrderStatus 中并没有值为 3 的命名枚举项。这导致后续的等值判断全部失效：

if (queryOrderStatus == QueryOrderStatus.Active)
{
    Console.WriteLine("Active");
}
// 无任何输出，业务逻辑被静默跳过

解决方案：使用 Enum.TryParse 进行安全转换

为避免上述隐患，应在转换过程中验证目标枚举是否包含该值。通过 Enum.TryParse<T> 方法，可以将字符串形式的枚举名解析为目标类型，并在解析失败时返回 false，从而实现可控的错误处理。

具体实现如下：

var domainState = OrderState.Locked;
QueryOrderStatus queryState;

// 尝试将源枚举的名称转换为目标枚举类型
if (!Enum.TryParse(domainState.ToString(), out queryState))
{
    // 解析失败说明目标枚举中不存在对应的名称
    throw new FormatException($"枚举项 '{domainState}' 在对应的DTO中不存在");
}

Console.WriteLine(queryState); // 正常情况会执行到此

运行上述代码，由于 QueryOrderStatus 中没有名为 "Locked" 的枚举项，TryParse 将返回 false，程序抛出 FormatException。