xml - 使用 XML 文档部署 Web API 项目时生成服务器上的 "Access is denied"

Question

为了使用 Web API 帮助页面为我的 Web API 项目生成 XML 文档，我必须选中项目属性的“构建”部分下的“XML 文档文件”选项。当我在本地构建时，这会正确生成文档。

但是，当我 checkin 时，我在构建服务器上收到以下错误:

CSC: Error generating XML documentation file 'c:\Builds\3...\Sources\CurrentVersion...\ProjectName\App_Data\XmlDocument.xml' ('Access is denied. ')

我不确定为什么会这样，因为无论如何它都会为每个构建创建一个新目录。我用谷歌搜索了这个问题并搜索了 Stack Overflow，但我找到的唯一解决方案是删除 XML 文档文件(这违背了使用 Web API 帮助页面的目的)。我该如何解决这个问题？

Answer 1

如果将 XML 文件 checkin 到 TFS，那么当 TFS 将文件获取到构建服务器上的工作区时，它将具有与该文件关联的“只读属性”。现在，当构建生成新的 XML 文件时，它将无法覆盖旧的 XML 文件，因为它具有只读属性。

解决方法是:a)使用您的构建脚本修改文件属性并使其可读写b) 删除 checkin 到 TFS 的 xml 文件，以便构建能够轻松生成 XML。

更新:如果您使用的是解决方案 b，如果该文件是您项目文件的一部分，请确保您也从 csproj 文件中删除该文件。