C＃摘要注释中的Xml字符串

StackOverflow https://stackoverflow.com/questions/607094

  •  03-07-2019
  •  | 
  •  

题

我正在记录我在C＃中编写的一些处理解析令牌的方法。由于系统其他领域的一些技术限制，这些令牌需要采用XML元素的形式（即<tokenName />）。我想将这些令牌的格式放在摘要语句中。

但是，这会引发错误：格式错误的XML - 名称以无效字符<！>“;”开头。是否有任何类型的转义字符序列可用于在我的C＃摘要注释中嵌入XML？

有帮助吗？

解决方案

使用标准XML转义。例如：

<summary>This takes a &lt;token1&gt; and turns it into a &lt;token2&gt;</summary>

输入或读取代码并不是一件容易的事，但是IntelliSense正确地解决了这个问题，你在工具提示中看到了正确的，可读的东西。

其他提示

使用CDATA部分。例如：

<![CDATA[ <name>Bob</name> ]]>

当您拥有更大的XML片段时，这在源代码中比在实体引用中编码特殊字符更优雅和可读。

如果要嵌入的XML本身包含CDATA部分，则需要使用多个CDATA部分，如 Stack Overflow上的另一个答案或维基百科。或者您可以始终使用普通实体引用，如此处的其他答案中所述。

我使用转义序列，因为VisualStudios工具提示不会显示CDATA部分内的任何内容。

现在已经很晚了，但遇到了同样的问题，使用<![CDATA[]]>会隐藏Intellisense中的评论。

替换<和>对我来说是很多工作（懒惰:)）。我发现用&lt;替换<=>对于Intellisense来说已经足够了，因为它使得xml无效并且适合于Intellisense在摘要块中作为文本进行解析。

以下是一个例子：

/// <summary>
/// Parse the queue process response
/// <para>&lt;?xml version="1.0" encoding="utf-16"?>&lt;result success="True">&lt;entity type="resource" operation="update" />&lt;/result></para>
/// <![CDATA[
/// <?xml version="1.0" encoding="utf-16"?><result success="True"><entity type="resource" operation="update" /></result>
/// ]]></summary>
/// <param name="response"></param>
/// <returns></returns>

智能感知将显示：

Parse the queue process response
<?xml version="1.0" encoding="utf-16"?><result success="True"><entity type="resource" operation="update" /></result>
许可以下： CC-BY-SA 和 归因
不隶属于 StackOverflow
scroll top