ASP.NET Core 7 Minimal API如何将QueryString绑定到POCO

在Minimal API里直接把POCO作为方法参数时，框架默认会按请求体解析，加[FromQuery]也不生效，这是因为Minimal API的参数绑定规则和传统Controller API不同。给你两个实用的解决办法：

方法一：用AsParameters()扩展方法（推荐） #

这是官方专门为Minimal API复杂参数绑定提供的方案，能自动把POCO的属性和QueryString参数一一绑定，支持可选属性，名称大小写不敏感。

首先定义你的Query记录：

public record Query(int? A, string? B, bool? C);

然后在端点映射时加上AsParameters()：

app.MapGet("/some/endpoint", async (Query query) =>
{
    // 直接使用query对象里的A、B、C属性
    return Results.Ok($"A: {query.A}, B: {query.B}, C: {query.C}");
}).AsParameters();

这样请求https://localhost:5000/some/endpoint?a=1&b=hello&c=true时，框架会自动把QueryString的值填充到Query对象的对应属性里，可选属性如果没传值会保持null。

方法二：自定义模型绑定器（适合复杂场景） #

如果需要对参数解析做自定义逻辑（比如特殊格式转换），可以实现IBinder接口：

1. 编写绑定器类：

public class QueryBinder : IBinder
{
    public async Task BindAsync(BinderContext context)
    {
        var queryCollection = context.HttpContext.Request.Query;
        
        // 手动解析QueryString参数到POCO
        var queryModel = new Query(
            int.TryParse(queryCollection["a"], out int a) ? a : null,
            queryCollection["b"],
            bool.TryParse(queryCollection["c"], out bool c) ? c : null
        );
        
        context.Result = ModelBindingResult.Success(queryModel);
        await Task.CompletedTask;
    }
}

2. 在端点中指定绑定器：

app.MapGet("/some/endpoint", async ([ModelBinder(typeof(QueryBinder))] Query query) =>
{
    return Results.Ok(query);
});

或者把绑定器注册为全局服务，这样所有Query类型的参数都会自动用这个绑定器：

builder.Services.AddSingleton<IBinder, QueryBinder>();

内容的提问来源于stack exchange，提问作者Pure.Krome