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

时间:2015-07-22 18:31:25

标签: c# visual-studio-2013

我想知道是否有办法让///文档注释在命名空间块中工作。它们在其他所有情况下都能正常工作,它们是否有在命名空间内被禁用的原因或者它是一个错误?我正在使用C#编写Visual Studio 2013编码。

谢谢!

1 个答案:

答案 0 :(得分:2)

这不是一个错误;它不受设计支持。 (关于决定背后的“原因”,我不知道。)

来自Compiler Warning (level 2) CS1587的说明:

  

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

上      

所有语言元素都不允许使用文档注释的推荐标签。例如,命名空间上不允许使用标记。有关XML注释的更多信息,请参阅Recommended Tags for Documentation Comments (C# Programming Guide)

这个文档中甚至还有一个例子,说明你正在尝试做什么。

(文档说VS2008位于顶部,但我确认我在VS2013中收到相同的警告。)