asp.net - 为什么我的 Web Api（完整框架）项目不会生成 Xml 文档文件

Question

我有一个 WebApi(2 - 我想，但谁知道这意味着什么) 项目（这是基于 VS 2019 模板），我正在尝试将 Xml 文档添加到其中，但我无法生成 Xml 文件。

我在 HelpPageConfig.cs 中未注释此行

config.SetDocumentationProvider(new XmlDocumentationProvider(HttpContext.Current.Server.MapPath("~/App_Data/XmlDocument.xml")));

我在构建属性中选中了相应的复选框（用于调试和发布）

我还向所有控制器和操作添加了适当的注释，但是当我构建时，不会生成 Xml 文件，因此我在运行时遇到异常

System.IO.FileNotFoundException: 'Could not find file 'C:\Users\steve\source\repos\EcmApi\EcmApi\App_Data\XmlDocument.xml'.'

我已经看到很多关于 Publishing 的问题（还不是我的问题……），还有很多提到 Swagger 的东西（我认为它的前身），但根本没有生成文件。

标签： asp.netasp.net-web-apidocumentation

Answer 1

看来，我不确定 HelpPageConfig.cs 文件中的文件名和构建属性中的文件名如何或何时不匹配。一旦我确定这些路径是相同的，事情就会奏效。