三斜杠注释在命名空间中不起作用

本文关键字:命名空间 不起作用 注释 | 更新日期: 2023-09-27 18:04:10

我想知道是否有一种方法可以让///文档注释在命名空间块内工作。它们在其他任何情况下都能正常工作,它们在名称空间内被禁用是有原因的,还是有bug?我在Visual Studio 2013中工作,用c#编码。

谢谢!

三斜杠注释在命名空间中不起作用

这不是bug;它不受设计的支持。(至于"为什么";

编译器警告(2级)CS1587:

XML注释没有放在有效的语言元素

并非所有语言元素都允许使用推荐的文档注释标签。例如,不允许在名称空间上使用标记。有关XML注释的更多信息,请参见文档注释的推荐标记(c#编程指南)。

在那篇文档中甚至有一个你想要做的例子。

(文档说VS2008在顶部,但我验证了我在VS2013中得到相同的警告。)