asp.net-web-api - WebAPI APIExplorer 文档没有收到我的摘要评论

Question

使用http://www.asp.net/web-api/overview/creating-web-apis/creating-api-help-pages文档指南并将这些应用于每个公共 API 控制器

/// <summary>
///  My own description comments
/// </summary>

但不知何故，我的摘要评论都没有被 XML 生成器 ApiExplorer 拾取。

有什么想法吗？？

Answer 1

在解决方案资源管理器中，右键单击项目并转到“属性”。在“构建”选项卡中，选中“XML 文档文件”复选框。

然后将生成的 XML 文件从 bin 文件夹复制到项目中，通常是“App_Data”文件夹。参考HelpPageConfig.csHelp Page MVC 区域中的文件。将有一个类似于config.SetDocumentationProvider(new XmlDocumentationProvider( HttpContext.Current.Server.MapPath("~/App_Data/Doc.xml")));更改 XML 文件名的注释行并取消注释该行。