查询字符串中的C# Web API可选参数

在C# Web API中，查询字符串中的可选参数允许你在URL中传递参数，这些参数不是必须的，可以在调用API时省略。这种机制提供了灵活性，使得客户端可以根据需要选择性地传递参数。

基础概念

可选参数是指在方法签名中定义的参数，它们可以有默认值。当调用该方法时，如果没有提供该参数的值，则使用默认值。

类型

路径参数：在URL路径中定义的参数。
查询参数：在URL的查询字符串中定义的参数。

应用场景

搜索功能：用户可以根据不同的条件进行搜索，而不必每次都填写所有条件。
分页：客户端可以指定页码和每页显示的记录数。
过滤：根据不同的属性过滤数据。

示例代码

假设我们有一个API端点用于获取用户列表，其中pageSize和pageNumber是可选参数。

[HttpGet("users")]
public IActionResult GetUsers(int pageSize = 10, int pageNumber = 1)
{
    // 实现获取用户列表的逻辑
    // 使用pageSize和pageNumber进行分页
    var users = _userService.GetUsers(pageSize, pageNumber);
    return Ok(users);
}

在这个例子中，pageSize和pageNumber都有默认值，客户端可以选择性地传递这些参数。

遇到的问题及解决方法

问题：如果客户端传递了无效的参数值（例如负数），应该如何处理？

解决方法：

验证输入：在方法内部验证参数的有效性。
返回错误响应：如果参数无效，返回适当的HTTP状态码和错误信息。

[HttpGet("users")]
public IActionResult GetUsers(int pageSize = 10, int pageNumber = 1)
{
    if (pageSize <= 0 || pageNumber <= 0)
    {
        return BadRequest("Invalid page size or page number.");
    }

    var users = _userService.GetUsers(pageSize, pageNumber);
    return Ok(users);
}

通过这种方式，可以确保API的健壮性，防止无效参数导致的潜在问题。