如何将方法描述的 XML 注释保留在单独的文件中？

Question

这个问题源于这个问题 代码文档多少算太多？

答案之一是保留您的 xml 文档位于单独的文件中。 我真的很喜欢这个答案，因为当我查看代码时，文档的冗长很烦人，另一方面，当通过智能感知搜索正确的方法或发布文档时，冗长的内容很有用。

答案是使用 include 标签

/// <include file="Documentation/XML/YourClass.xml" path="//documentation/members[@name='YourClass']/*"/>

还有一篇关于 include 标签的 MSDN 文章 这里。

我想出了如何保留摘要信息，但我不知道，也找不到如何将方法文档放在那里。 （这比课堂总结本身更重要。

Answer 1

答案很简单。 读取生成的 xml 文件。 他们给出了分离的 xml 文件应该是什么样子的想法。

读取生成的 xml 文件以及如何描述方法（带有参数等）：

<member name="M:BitFactory.Logging.Logger.DoLog(BitFactory.Logging.LogEntry)">
    <summary>
    Really log aLogEntry. (We are past filtering at this point.)
    Subclasses might want to do something more interesting and override this method.
    </summary>
    <param name="aLogEntry">The LogEntry to log</param>
    <returns>true upon success, false upon failure.</returns>
</member>

T、M、F 前缀类型、方法、字段。