多行样式注释导致XML文档警告

时间:2013-02-15 16:57:11

标签: c# visual-studio-2010 xml-documentation

我在C#项目中有很多多行样式注释,当项目选项设置为输出XML文档文件时,它们都会触发警告 XML注释不会放在有效的语言元素上 。在Visual Studio 2010中观察到此行为。

如果不将所有这些评论更改为单行样式评论,我该怎么做才能防止这些警告被触发?

简化示例:

public class Foo
{
    /// <summary>
    /// Does something.
    /// </summary>
    public void DoSomething()
    {
        /**
         * Do something interest here.
         */
    }
}

1 个答案:

答案 0 :(得分:7)

只需删除评论第一行的第二个*即可。

使用/**打开C风格的XML文档评论。