.NET项目文件中DocumentationFile与GenerateDocumentationFile可否同时使用？

C#项目XML文档生成配置生效规则 #

两个配置项完全可以同时在项目文件中显式声明，不会引发项目加载报错，二者不存在合并生效的逻辑，优先级规则如下：

• 首先校验GenerateDocumentationFile开关值：
  • 若该值设为false，XML文档生成功能会被全局关闭，无论是否配置了DocumentationFile，该配置都会被直接忽略
  • 若该值设为true，再判断DocumentationFile是否有显式配置：
    • 存在显式DocumentationFile路径配置时，MSBuild会按照指定的路径生成XML文档，覆盖GenerateDocumentationFile默认的「输出目录+项目同名.xml」生成规则
    • 没有显式配置DocumentationFile时，才会使用GenerateDocumentationFile的默认规则生成文档

如果你的分析器要做配置合法性校验，按照上述优先级顺序判断即可，不需要额外处理冲突场景，MSBuild本身已经有固定的解析逻辑。

内容的提问来源于stack exchange，提问作者SENya