VS xml文档,继承自基类

发布于 2024-12-14 19:59:54 字数 143 浏览 1 评论 0原文

我已启用在我的类库上生成 XML 文档,该类库有一个父类和许多从中继承的类。有几个属性是从基类属性中重写的。我想在基类属性上添加 XML 注释,并在覆盖的属性上获得相同的注释。不幸的是,当我生成 XML 文档文件时,重写的属性上缺少注释。是否可以覆盖基类的 xml 注释?

I have enabled generating XML documentation on my class library which has one parent class and many inherited classes from it. There are several properties overridden from base class properties. I would like to put XML comments on base class properties and get the same comments on overridden properties. Unfortunately when I generate XML Doc file the comments are missing on overridden properties. Is it possible to override xml comments from base class?

如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。

扫码二维码加入Web技术交流群

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

评论(1

神也荒唐 2024-12-21 19:59:54

根据您用来生成外部文档的工具(Doxygen、Sandcastle 等),您可以使用 include 或类似元素从其他地方提取文档,以便进行共享。

另一种方法是使用 seeseealsosa 条目(同样,取决于您处理文档注释的工具)来引用基础类属性/方法,但这意味着指向基本条目的超链接,而不是内联文档。

第三种可能性是我的插件,AtomineerUtils。 (除其他外)它将把文档从基类/接口复制到您的覆盖/实现中,因此复制文档只需要一点时间。然后,您可以修改复制的文档,使其更具体地针对其所附加的特定方法。

Depending on the tools you use to generate the external documentation (Doxygen, Sandcastle, etc) you may be able to use an include or similar element to pull in documentation from elsewhere so it can be shared.

Another approach is to use see, seealso or sa entries (again, depending on the tool you process the documentation comments with) to reference the base class property/method, but this will mean a hyperlink to the base entry, not inlined documentation.

A third possibiility is my addin, AtomineerUtils. (Among other things) it will duplicate the documentation from the base class/interface up into your override/implementation, so it only takes a moment to copy the documentation. You can then modify the copied documentation to be more specific to the particular method it is attached to.

~没有更多了~
我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
原文