Swashbuckleでクエリ文字列パラメータを文書化するにはどうすればよいですか？

Question

Swashbuckleは、Swagger APIのドキュメントを作成するためにC＃XMLコメントを抽出する素晴らしい仕事をしています。 Swaggerはクエリ文字列パラメータのドキュメント化をサポートしています。しかし、Swashbuckleがそれらをエクスポートするようにクエリ文字列パラメータをXMLで文書化する方法がある場合は、それを見つけられません。出力には表示されません

/// <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(); 

そしてsearch：

は、私のようなものを持っています。私は?を取り除こうとしましたが、それは助けになりませんでした。私は、XMLコメントがこれを直接サポートしていないと思われます。それが本当であれば、ベストプラクティスの仕事を探しています。 <remarks>ブロックに2つの弾丸を追加することを検討しています。どんな良いアイデアですか？

Answer 1

@jpsは正しい方向に私を指摘しました。ありがとう！

私は終わった：あなたは `ListUsers`メソッドに` search`パラメータを追加することはできません理由がある

/// <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;