Blazor中如何将页面URL参数绑定为枚举的字符串值？

Blazor默认路由参数对枚举的绑定仅支持整数值，你尝试的JsonStringEnumConverter是用于JSON序列化的，和路由参数的绑定逻辑不相关，所以无效。以下是实现字符串绑定的具体方案：

1. 自定义枚举参数转换器 #

创建一个实现IParameterConverter的转换器类，专门处理枚举与字符串的转换，支持枚举名或自定义EnumMember值：

using Microsoft.AspNetCore.Components;
using System.Reflection;
using System.Runtime.Serialization;

public class EnumStringConverter<TEnum> : IParameterConverter 
    where TEnum : struct, Enum
{
    public bool TryConvert(object? value, Type targetType, out object? result)
    {
        result = default;
        if (value is not string stringValue)
            return false;

        var enumType = typeof(TEnum);
        // 先匹配EnumMember的自定义值
        foreach (var field in enumType.GetFields(BindingFlags.Public | BindingFlags.Static))
        {
            var enumMemberAttr = field.GetCustomAttribute<EnumMemberAttribute>();
            if (enumMemberAttr != null && 
                enumMemberAttr.Value.Equals(stringValue, StringComparison.OrdinalIgnoreCase))
            {
                result = Enum.Parse(enumType, field.Name);
                return true;
            }
        }

        // 再匹配枚举名（大小写不敏感）
        return Enum.TryParse(stringValue, ignoreCase: true, out TEnum enumValue) 
            && Enum.IsDefined(enumValue)
            ? (result = enumValue) != null
            : false;
    }
}

2. 注册转换器到Blazor路由系统 #

在Program.cs中添加转换器注册，让Blazor识别你的枚举类型的字符串转换规则：

builder.Services.AddRazorComponents()
    .AddInteractiveServerComponents() // 根据你的项目类型选择Server/WebAssembly
    .AddInteractiveWebAssemblyComponents()
    .AddParameterConverter<EnumStringConverter<MyEnumType>>(); // 替换为你的枚举类型

3. 配置路由与参数 #

路由中不需要:int约束，直接使用枚举参数即可：

@page "/index/{MyEnum}"

[Parameter]
public MyEnumType MyEnum { get; set; }

4. （可选）设置枚举自定义字符串值 #

如果需要使用非枚举名的自定义字符串，给枚举成员添加EnumMemberAttribute：

using System.Runtime.Serialization;

public enum MyEnumType
{
    [EnumMember(Value = "my-first-value")]
    FirstValue,
    [EnumMember(Value = "my-second-value")]
    SecondValue
}

此时访问/index/my-first-value就能正确绑定到MyEnumType.FirstValue。

关键说明 #

• 转换器默认支持大小写不敏感匹配，若需严格大小写，移除StringComparison.OrdinalIgnoreCase和Enum.TryParse的ignoreCase: true参数即可。
• 转换器会通过Enum.IsDefined验证枚举值有效性，避免无效值绑定。

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