WebAPI APIExplorer 文档没有收到我的摘要评论

【问题标题】：WebAPI APIExplorer Documentation does not pick up my Summaries commentsWebAPI APIExplorer 文档没有收到我的摘要评论
【发布时间】：2013-10-16 01:53:55
【问题描述】：

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

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

但不知何故，XML 生成器 ApiExplorer 没有获取我的摘要 cmets。

有什么想法吗？？

【问题讨论】：

标签： asp.net-web-api asp.net-mvc-apiexplorer

【解决方案1】：

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

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

【讨论】：

是的，该帖子的问题是 HelpPageConfig 上的文件名必须与您在项目属性中设置的文件名完全相同，并且通常采用项目名称。伟大的德米特里。