.NET xml文档 – 继承文档
发布时间：2020-12-16 01:53:11 所属栏目：百科 来源：网络整理
导读：NDoc有一个XML元素inheritdoc，它允许您从父类(或实现的接口)继承成员的文档。但是，Visual Studio(即C#编译器)不理解此标记，并抱怨文档不存在或完整。 StyleCop和一些其他工具。有另一种方法吗？如何保持文档完整，但没有重复XML描述？ 一个替代方法是使用
|
NDoc有一个XML元素inheritdoc，它允许您从父类(或实现的接口)继承成员的文档。但是，Visual Studio(即C#编译器)不理解此标记，并抱怨文档不存在或完整。 StyleCop和一些其他工具。有另一种方法吗？如何保持文档完整，但没有重复XML描述？
一个替代方法是使用
GhostDoc – Visual Studio的加载项，自动为您生成注释。这与当前的XML描述重复，这是你想要避免的一部分 – 但至少它自动为你。
如果你完全离开文档完全为继承的方法或覆盖接口方法会发生什么？我怀疑这取决于你如何配置NDoc，但肯定在MSDN文档似乎只是自然继承的文档 – 一个快速检查表明VS不会whinge当你不产生文档继承的方法。值得一试，当然。 （编辑：李大同） 【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容! |