如何用Swashbuckle记录查询字符串参数？

Question

Swashbuckle在提取C# XML注释以制作Swagger API文档方面做得很好。Swagger 支持记录查询字符串参数。但是，如果有一种方法可以在XML中记录查询字符串参数，以便Swashbuckle导出它们，我还没有找到它。

我有这样的东西：

    /// <summary>
    /// List all users
    /// </summary>
    /// <param name="?search">String to search for in user IDs and names</param>
    /// <returns>An array of users</returns>
    /// <response code="200">OK</response>
    [ResponseType(typeof(IEnumerable<User>))]
    [Route("")]
    [HttpGet]
    public IHttpActionResult ListUsers()
    {
        IEnumerable<User> users;

        // "?search=<substring>" in the URI searches for users
        // Adapted from https://stackoverflow.com/questions/10656841
        var searchString = Request.GetQueryNameValuePairs()
            .Where(nv => nv.Key == "search")
            .Select(nv => nv.Value)
            .DefaultIfEmpty("")
            .FirstOrDefault();

并且＜code＞搜索＜/code＞不会显示在输出中。我尝试删除＜code＞没有帮助。我怀疑XML注释不直接支持这一点。如果这是真的，我正在寻找一个最佳实践解决方案。我正在考虑在＜code＞中添加几个项目符号

Answer 1

@jps给我指了正确的方向。谢谢！

我的结局是：

    /// <summary>
    /// List all users
    /// </summary>
    /// <param name="search">String to search for in user IDs and names</param>
    /// <returns>An array of users</returns>
    /// <response code="200">OK</response>
    [ResponseType(typeof(IEnumerable<User>))]
    [Route("")]
    [HttpGet]
    public IHttpActionResult ListUsers([Optional]string search)
    {
        IEnumerable<User> users;

        var searchString = search == null ? string.Empty : search;