【问题标题】:Can we selectively generate XML documentation in Visual Studio?我们可以在 Visual Studio 中选择性地生成 XML 文档吗?
【发布时间】:2020-06-09 02:02:32
【问题描述】:

我正在寻找一个属性或可以用来标记“我希望在我的 xml 文档中使用它”的东西,比如白名单。

情况是我希望为某些控制器生成xml文档以大摇大摆地显示。但是,许多事情不应该记录在案——尤其是自动生成的代码,例如 CRM 代理类型,其中包含数十万个不需要的定义。

我已经在我的项目设置中启用了生成“Xml 文档”,并且我已经禁用了关于未记录的公共项目的警告,因此自动构建在合理的时间内完成,但是 Visual Studio 正在生成一个 8.1mb 的 xml 文档文件,而 Swagger 需要很长时间载入。其中 90% 是自动生成的代理废话。我希望能够在我关心的控制器中说“记录这个文件” - 这可能吗?

【问题讨论】:

    标签: c# visual-studio swagger documentation


    【解决方案1】:

    我不知道如何在没有任何工具的情况下直接执行此操作。这可以通过VSdocman 来完成(我是它的作者)。可以generate your own XML doc file。然后,您可以自定义要记录的内容,例如特定文件/文件夹、签名和属性的正则表达式过滤器、可访问性(公共/私有/...)、特殊 XML 文档标记 等。

    【讨论】:

    • 这不是免费产品。
    猜你喜欢
    • 2010-10-25
    • 2010-12-28
    • 1970-01-01
    • 1970-01-01
    • 2011-05-02
    • 1970-01-01
    • 2012-05-23
    • 1970-01-01
    • 1970-01-01
    相关资源
    最近更新 更多