Warning: file_get_contents(/data/phpspider/zhask/data//catemap/2/visual-studio-2010/4.json): failed to open stream: No such file or directory in /data/phpspider/zhask/libs/function.php on line 167

Warning: Invalid argument supplied for foreach() in /data/phpspider/zhask/libs/tag.function.php on line 1116

Notice: Undefined index: in /data/phpspider/zhask/libs/function.php on line 180

Warning: array_chunk() expects parameter 1 to be array, null given in /data/phpspider/zhask/libs/function.php on line 181
Visual studio Visual Studio XML注释(摘要)和特殊字符_Visual Studio_Visual Studio 2010 - Fatal编程技术网

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

Visual studio Visual Studio XML注释(摘要)和特殊字符,visual-studio,visual-studio-2010,Visual Studio,Visual Studio 2010,我在一个C#/Wpf项目中有一个方法,我想使用如下XML注释对其进行注释/记录 /// <summary> /// Initialises Drag & Drop /// </summary> void initDragDrop() { } // ///初始化拖放 /// void initDragDrop() { } 当我现在在项目中的某个地方使用此方法并将鼠标悬停在其上时,我得到了消息 “XML注释包含无

我在一个C#/Wpf项目中有一个方法,我想使用如下XML注释对其进行注释/记录

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

    }
//
///初始化拖放
/// 
void initDragDrop()
{
}
当我现在在项目中的某个地方使用此方法并将鼠标悬停在其上时,我得到了消息 “XML注释包含无效的XML:此处不允许有空格”(我手动将冒号后面的文本翻译为英语,因此它可能不在visual studio中)。 我发现问题出在“&”符号上,如果我去掉它,它就可以正常工作。但是我想保留它,那么如何在XML摘要中转义它呢?我尝试了“\&”,但这不起作用


谢谢你的提示

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

//
///初始化拖动&;滴
/// 
void initDragDrop()
{
}

我可能在下一点上错了,但我认为您甚至不能使用CDATA节来避免实体,因为它会破坏注释。您必须键入整个
&实体。

实际上,您可以使用CDATA。下面是我的一个项目的示例:。另一种选择是将文档全部移动到一个单独的文件中,并将其移动到源文件中。谢谢你们的回复!肯特,通过你的链接,我看到你的课程有很好的文档记录。我猜你是在从中生成一些HTML?您正在使用哪个工具执行此任务?上次我寻找这些工具时,它们都是早期的dotnet版本,或者对于初学者来说很难使用。我会接受joels的回答,首先是一个简短的解决方案,其次kent将他的解决方案添加为注释,不可标记,否则我也会标记;-)哦,还有一个问题,VisualStudio有没有可能直接告诉我我在XML中犯了错误?目前,我只在悬停记录的方法时看到错误。像代码中的错误这样的直接错误会很有用。别忘了对和(“”)也需要这样做。如果您想以HTML、CHM或其他格式生成类似MSDN的文档,可以使用免费的Sandcastle或我们的VSdocman。VSdocman还包含自动转义所有必要字符的注释编辑器。@stefan:我使用Sandcastle。您可以通过从下载文档来查看输出。您可以在中看到我如何在MSBuild文件中构建文档。
/// <summary>
/// Initialises Drag &amp; Drop
/// </summary>
void initDragDrop()
{

}