Blazor中使用SupplyParameterFromQuery传递Enum参数报错如何解决？

Blazor的SupplyParameterFromQuery默认不支持直接解析枚举类型，因为查询字符串传递的是纯文本，框架无法自动完成字符串到枚举的转换。以下两种方案可以解决这个问题：

方法一：中间字符串属性转换（轻量快捷） #

新增一个字符串属性接收查询参数，再手动转换为枚举类型，适合单个页面的简单场景：

修改Counter.razor代码：

public enum EnumType { One, Two, Three }

// 接收查询字符串的中间属性，指定与URL参数名一致
[SupplyParameterFromQuery(Name = "Number")]
public string? NumberString { get; set; }

// 实际业务使用的枚举属性
public EnumType Number { get; set; }

protected override void OnParametersSet()
{
    if (!string.IsNullOrEmpty(NumberString) 
        && Enum.TryParse<EnumType>(NumberString, out var parsedValue))
    {
        Number = parsedValue;
    }
    // 可选：解析失败时设置默认值
    else
    {
        Number = EnumType.One;
    }
}

Index.razor代码保持不变：

@using static BlazorApp1.Pages.Counter
<a href="/counter?Number=@EnumType.One" >counter page: One</a>

方法二：全局自定义查询字符串解析器（优雅复用） #

实现Blazor的IQueryStringValueParser接口，注册后全局支持枚举类型解析，适合多页面需要枚举绑定的场景：

1. 编写枚举解析器 #

创建EnumQueryStringValueParser类：

using Microsoft.AspNetCore.Components;

public class EnumQueryStringValueParser : IQueryStringValueParser
{
    public bool CanParse(Type targetType)
    {
        // 仅处理枚举类型
        return targetType.IsEnum;
    }

    public object? Parse(Type targetType, string value)
    {
        // 尝试解析字符串为枚举，支持大小写忽略
        if (Enum.TryParse(targetType, value, ignoreCase: true, out var result))
        {
            return result;
        }
        // 解析失败时返回枚举默认值（也可根据需求抛出异常）
        return Activator.CreateInstance(targetType);
    }
}

2. 注册解析器 #

在Program.cs中添加服务注册：

builder.Services.AddSingleton<IQueryStringValueParser, EnumQueryStringValueParser>();

3. 原代码直接使用 #

此时Counter.razor的初始代码无需修改：

public enum EnumType { One, Two, Three }

[SupplyParameterFromQuery]
public EnumType Number { get; set; }

Index.razor保持不变，框架会自动完成字符串到枚举的转换。

额外说明 #

• 如果需要传递枚举的数值（比如/counter?Number=1对应EnumType.Two），可以修改解析逻辑支持数值解析，同时在跳转时传递((int)EnumType.Two)；
• 方法一无需额外配置，适合快速解决单个页面问题；方法二一次配置全局生效，代码更简洁。

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