一个控制器的操作未出现在帮助文档中
One controller's actions not appearing in help docs
我有一个 MVC Web API 项目,它工作正常,但由于某种原因,帮助文档中的条目仅针对一个控制器没有出现。
直到最近这一切都很好,不幸的是,虽然我不知道它在什么时候消失了,但它肯定曾经在那里。
XML 的评论看起来都不错。
XmlDocument.xml 文件看起来正确。
有没有办法在帮助文档中指定哪些控制器和方法功能?
我怎样才能确保显示此控制器的操作?
如果有帮助,这是第一个动作的片段:
public class UserController : ApiController
{
/// <summary>
/// Get details of a user or all users, including accounts and group memberships
/// </summary>
/// <param name="username">The name of the user, if a single result is required</param>
/// <param name="account">The account id, if multiple results are required</param>
/// <param name="offset">The first row to return</param>
/// <param name="limit">The maximum number of rows to return</param>
/// <param name="sortby">The column to sort by, if required</param>
/// <param name="order">The sort order; asc[ending] (default) or desc[ending]</param>
/// <returns>Response structure including status and error message (if appropriate), as well as User structure including account and group details</returns>
[Route("user")]
[CombinedAuthentication(AuthLevel = "2")]
[HttpGet]
[AcceptVerbs("GET")]
public UserGetResponse Get(string username = "", int account = 0, int offset = 0, int limit = 0, string sortby = "", string order = "")
{
if (!string.IsNullOrEmpty(username))
{
return new UserGetResponse(username);
}
else
{
return new UserGetResponse(account, offset, limit, sortby, order);
}
}
}
此位停止生成帮助文档条目:
[AcceptVerbs("GET")]
我删除了那个,一切都很好!
我有一个 MVC Web API 项目,它工作正常,但由于某种原因,帮助文档中的条目仅针对一个控制器没有出现。
直到最近这一切都很好,不幸的是,虽然我不知道它在什么时候消失了,但它肯定曾经在那里。
XML 的评论看起来都不错。 XmlDocument.xml 文件看起来正确。
有没有办法在帮助文档中指定哪些控制器和方法功能? 我怎样才能确保显示此控制器的操作?
如果有帮助,这是第一个动作的片段:
public class UserController : ApiController
{
/// <summary>
/// Get details of a user or all users, including accounts and group memberships
/// </summary>
/// <param name="username">The name of the user, if a single result is required</param>
/// <param name="account">The account id, if multiple results are required</param>
/// <param name="offset">The first row to return</param>
/// <param name="limit">The maximum number of rows to return</param>
/// <param name="sortby">The column to sort by, if required</param>
/// <param name="order">The sort order; asc[ending] (default) or desc[ending]</param>
/// <returns>Response structure including status and error message (if appropriate), as well as User structure including account and group details</returns>
[Route("user")]
[CombinedAuthentication(AuthLevel = "2")]
[HttpGet]
[AcceptVerbs("GET")]
public UserGetResponse Get(string username = "", int account = 0, int offset = 0, int limit = 0, string sortby = "", string order = "")
{
if (!string.IsNullOrEmpty(username))
{
return new UserGetResponse(username);
}
else
{
return new UserGetResponse(account, offset, limit, sortby, order);
}
}
}
此位停止生成帮助文档条目:
[AcceptVerbs("GET")]
我删除了那个,一切都很好!