这个问题源于这个问题 Code documentation how much is too much?
答案之一是将您的 xml 文档保存在单独的文件中。我真的很喜欢这个答案,因为当我查看代码时,文档的冗长令人讨厌,另一方面,在通过智能感知搜索正确的方法或发布文档时,冗长很有用。
答案是使用包含标签
/// <include file="Documentation/XML/YourClass.xml" path="//documentation/members[@name='YourClass']/*"/>
这里还有一篇关于包含标签的 MSDN 文章。
我想出了如何保留摘要信息,但我不知道也找不到如何将方法文档放在那里。(这比课程摘要本身更重要。