Visual Studio XML注释(摘要)和特殊字符

时间:2010-04-20 16:06:05

标签: visual-studio visual-studio-2010

我在C#/ Wpf项目中有一个方法,我想使用像这样的XML注释来评论/记录它

    /// <summary>
    /// Initialises Drag & Drop
    /// </summary>
    void initDragDrop()
    {

    }

当我现在在我的项目中的某个地方使用此方法并将鼠标悬停在它上面时,我收到了消息 “XML注释包含无效的XML:在这个地方,不允许使用空格”(我将冒号后的文本手动翻译成英文,因此它可能不是字面上的视觉工作室)。 我发现问题是“&amp;”标志,如果我删除它,它工作正常。但是我想保留它,那么如何在XML摘要中将其转义呢?我试过“\&amp;”但这不起作用。

感谢任何提示!

1 个答案:

答案 0 :(得分:18)

请记住&amp; character在xml(实体的开头)中有特殊含义。你需要写这样的评论(烦人,我知道):

/// <summary>
/// Initialises Drag &amp; Drop
/// </summary>
void initDragDrop()
{

}

我可能在下一点上错了,但我认为你甚至不能使用CDATA部分来避开实体,因为它会破坏评论。您必须输入整个&amp;实体。