【问题标题】:How to include the comments xml in MrefBuilder (EXE)如何在 MrefBuilder (EXE) 中包含注释 xml
【发布时间】:2016-08-21 08:15:20
【问题描述】:

我需要找出两个程序集之间的差异。我这样做的方式是使用 MRefBuilder 为两个版本生成的 xml 文件。我使用 C# 来比较 xml 文件,并仅获取已更改的方法、属性和文件。然后,我将差异保存在 XML 文件中,并使用 XSLT 生成 HTML 报告

我有一个新要求;添加这些额外的 cmets

<summary>This method does this</summary>
<param name="prm1"></param> 

在我的 HTML 报告中。 虽然这些 cmets 包含在 VisaulStudio 生成的 XML 报告中,但我不知道如何将它们添加到 MRefBuilder 生成的报告中。

有没有办法——除了代码——可以做到这一点?

【问题讨论】:

    标签: c# xml sandcastle


    【解决方案1】:

    小故事:我看到您的工作流程是您的(现有)C# 代码比较程序集的两个 xml 文件的任务。

    据我了解您的工作流程:

    程序集 => MRefBuilder => 两个 XML => 你的 C# 代码 => 一个 diff.xml => XSLT = HTML

    但是我对你的... now I got the xml generated by visual studio which has these comments.有点困惑

    我的 XML 文档文件 (!) 中总是有 cmets,具体取决于内联代码 cmets。所以,如果你想通过 XSLT 生成一个从 diff.xml 派生的 HTML 报告,我认为你需要自己做。

    我假设您已安装 Visual Studio 并集成了 Sandcastle 帮助文件生成器,并且您检查了“生成输出”部分中的 XML 文档文件选项。

    顺便说一句 - 我在 Visual Studio 中的 Sandcastle 帮助文件生成器选项如下所示:

    【讨论】:

      猜你喜欢
      • 2012-01-24
      • 2018-07-16
      • 1970-01-01
      • 2020-04-17
      • 2014-12-11
      • 2022-10-02
      • 1970-01-01
      • 2012-10-15
      • 2013-04-10
      相关资源
      最近更新 更多