如何在C# HTTP API控制器Action中实现无需传递全部参数的动态参数机制

嘿，这个问题其实ASP.NET Core本身就提供了简洁的解决方式，你之前的做法可能走进了一个小误区，咱们一步步来梳理：

核心误区纠正 #

你之前尝试给参数设置空字符串默认值（string firstname = ""），但误以为必须在URL里传firstname=这种空值——其实完全不需要！ASP.NET Core的查询参数绑定逻辑会自动处理未传递的参数：如果参数是引用类型（比如string），未传递时会默认设为null；如果给参数指定了默认值，未传递时就会用你设置的默认值。

方案1：直接使用可空/默认值参数（适合参数较少的场景） #

你只需要把参数设置为允许为null，或者直接利用string本身的引用类型特性（默认就是null），就能实现只传部分参数的需求，代码示例：

[HttpGet]
public async Task TestParam(string firstname = null, string lastname = null, string persnr = null)
{
    // 未传递的参数会自动设为null，这里可以用??来替换为空字符串输出
    Console.WriteLine("Firstname: " + (firstname ?? ""));
    Console.WriteLine("Lastname: " + (lastname ?? ""));
    Console.WriteLine("Persnr: " + (persnr ?? ""));
}

甚至更简洁，因为string作为引用类型，默认就是null，你可以不用写默认值：

[HttpGet]
public async Task TestParam(string firstname, string lastname, string persnr)
{
    // 未传递的参数会直接是null
    Console.WriteLine("Firstname: " + firstname);
    Console.WriteLine("Lastname: " + lastname);
    Console.WriteLine("Persnr: " + persnr);
}

这样你就可以直接用URL/?persnr=123、URL/?firstname=Test&persnr=123等任意组合的URL请求，完全不需要传递其他空参数。

方案2：使用DTO模型类（适合参数较多的场景） #

如果你的参数数量较多，或者后续可能扩展，推荐用一个专门的DTO（数据传输对象）类来封装参数，这样代码更整洁易维护：

首先定义参数模型：

public class PersonQueryParams
{
    public string Firstname { get; set; }
    public string Lastname { get; set; }
    public string Persnr { get; set; }
}

然后修改控制器Action：

[HttpGet]
public async Task TestParam([FromQuery] PersonQueryParams queryParams)
{
    Console.WriteLine("Firstname: " + queryParams.Firstname);
    Console.WriteLine("Lastname: " + queryParams.Lastname);
    Console.WriteLine("Persnr: " + queryParams.Persnr);
}

这个方案同样支持只传递部分参数，未传递的属性会自动设为null，而且后续新增参数只需要修改模型类即可，不需要改动Action的方法签名。

总结 #

• 参数较少时：直接使用单个可空参数即可，ASP.NET Core会自动处理未传递的参数
• 参数较多或需扩展时：使用DTO模型类，代码更具可维护性

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