如何正确转义 Xml 文档中的<代码>示例的内容

本文关键字:代码 Xml 转义 文档 何正确 | 更新日期: 2023-09-27 18:19:44

这是转义VB和C-Sharp非法字符的方法,例如.Net Xml文档<code>标签中的<>&字符?

在下面的示例中,Intellisense 突出显示了>字符,因为我需要对其进行转义,它说生成文档时不会包含代码,因为这个原因。

''' ------------------------------------------------------------------------
''' <summary>
''' </summary>
''' ------------------------------------------------------------------------
''' <example> This is a code example.
''' <code>
''' 
''' Dim currentPosition As Long = CLng(player.Position.TotalMilliseconds)
''' 
''' If Not ((currentPosition + 5000) >= player.Length) Then
'''    player.Seek(currentPosition + 5000)
''' End If
''' 
''' </code>
''' </example>
''' ------------------------------------------------------------------------
Sub Something
End Sub

那么,我应该如何转义代码内容?

我对此表示怀疑,因为<code>标签的内容被视为文字文本,那么如果我添加一个CDATA标签以避免 IntelliSense 错误,当我使用该文档生成 Chm/Html 文件时会发生什么?,我的意思是CDATA标记符号将在代码示例中表示为升文本,以这种方式引起居住, 还是什么?。

有人可以提供一个例子来做正确的事情吗?

如何正确转义 Xml 文档中的<代码>示例的内容

您需要使用与普通 XML(或 HTML(文档中相同的转义类型(有关详细信息,请参阅此处(。

&替换为&amp;<替换为&lt;>替换为&gt;。您可能要注意的另一个是引号字符。 "被替换为&quot;