C#/.NET5中如何准确判断任意数值是否属于指定枚举

你碰到的两个坑都是C#枚举的默认设计行为，不是bug：

• Enum.TryParse 对纯数字字符串的解析逻辑不会做成员合法性校验：只要字符串能被解析为整数，无论数值是否对应已定义的枚举成员，都会返回true，直接把整数值强转为枚举类型输出，这就是Enum.TryParse<SomeEnum>("1", out _)返回true的原因。
• 整数值转枚举时默认在unchecked上下文中执行，会自动按枚举的底层类型长度做截断：比如你定义的枚举底层类型是2字节长度的ushort，传入4字节的uint.MaxValue（值为0xFFFFFFFF）时，会直接截断为低2字节的0xFFFF，刚好匹配SomeEnum.Unknown，最终导致Enum.IsDefined误判。

不要靠TryParse+IsDefined的简单组合做校验，必须补上「数值范围无截断」的校验环节，才能覆盖所有边界场景。下面的通用实现适配所有枚举底层类型（byte/sbyte/short/ushort/int/uint/long/ulong），在.NET 5及以上版本均可直接使用：

using System;

public static class EnumStrictParser
{
    public static bool TryParseStrict<TEnum>(string input, out TEnum result, bool ignoreCase = false)
        where TEnum : struct, Enum
    {
        result = default;
        // 第一步：过滤完全无法解析的非法输入
        if (!Enum.TryParse<TEnum>(input, ignoreCase, out var parsedValue))
        {
            return false;
        }

        // 非数字输入为枚举成员名称，不存在截断问题，直接校验成员存在性即可
        if (!IsPureNumericString(input))
        {
            return Enum.IsDefined(parsedValue);
        }

        // 数字输入场景：校验原始值转换到底层类型时无溢出、无截断
        Type underlyingType = Enum.GetUnderlyingType(typeof(TEnum));
        try
        {
            // 直接将原始字符串转换为枚举底层类型，溢出直接判定失败
            object rawUnderlyingValue = Convert.ChangeType(input.Trim(), underlyingType);
            // 用转换后的底层值重新生成枚举，和TryParse结果比对，不一致说明存在截断
            TEnum validEnum = (TEnum)Enum.ToObject(typeof(TEnum), rawUnderlyingValue);
            if (!parsedValue.Equals(validEnum))
            {
                return false;
            }
            // 最终校验值为已定义的枚举成员
            return Enum.IsDefined(validEnum);
        }
        catch (OverflowException)
        {
            // 数值超出底层类型范围，直接返回失败
            return false;
        }
        catch (FormatException)
        {
            return false;
        }
    }

    private static bool IsPureNumericString(string input)
    {
        string trimmed = input.Trim();
        if (string.IsNullOrEmpty(trimmed)) return false;
        
        // 兼容带正负号的数字格式
        int startIdx = trimmed[0] is '-' or '+' ? 1 : 0;
        if (startIdx >= trimmed.Length) return false;

        for (int i = startIdx; i < trimmed.Length; i++)
        {
            if (!char.IsDigit(trimmed[i]))
            {
                return false;
            }
        }
        return true;
    }
}

用你提到的几个测试用例验证，结果完全符合预期：

• 输入"1"：转换为ushort值为1，无对应枚举成员，返回false
• 输入uint.MaxValue.ToString()（即"4294967295"）：转换为ushort时触发溢出，直接返回false，不会误判为Unknown
• 输入"65535"/"0xFFFF"：正常转换为ushort的0xFFFF，匹配SomeEnum.Unknown，返回true
• 输入"FirstValue"：匹配名称对应成员，返回true
• 输入"40320"（即0x9D80）：匹配FirstValue，返回true

注意：不要依赖外层加checked关键字解决截断问题，Enum类内部的转换逻辑默认运行在unchecked上下文，外层checked块不会拦截内部的截断行为。如果不需要兼容枚举名称输入，只校验数值的话，可以直接把原始输入转换为枚举底层类型后，再调用Enum.ToObject生成枚举值做IsDefined校验，逻辑更简单。

内容的提问来源于stack exchange，提问作者Felix Arnold