asp.net - 未在发布时更新 Web API 的 XML 帮助文档

Question

每 online documentation以及 HelpPageConfig.cs 中的注释代码，启用 XML 文档将一个 XML 文件添加到 ~App_data/name_of_file.xml。然后将项目构建属性设置为匹配该路径。

但是，在发布时，XML 文件似乎没有发布，这会导致访问 api 的帮助页面时出现 YSOD。我已经验证文件的构建操作设置为内容。我也试过使用复制到输出目录没有效果。

无论如何，出于好奇，我想知道是否有使用他们推荐的文件位置的解决方案，或者它是否只是某种过时的推荐；否则，我想我可以尝试将其移动到 bin 目录。

我正在使用 Web API 2.1 帮助页面 nuget 包。

Answer 1

我在尝试发布到 Azure 时遇到了类似的问题。我必须在项目中包含帮助文档 *.xml 文件，然后他们才能发布。



还要确保在您的发布选项中“ 从 App_Data 文件夹中排除文件 ”如果您将它们采购到 App_Data 文件夹中，则未选中它们。