如何正确转义 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(或 HTML(文档中相同的转义类型(有关详细信息,请参阅此处(。
将&
替换为&
,<
替换为<
,>
替换为>
。您可能要注意的另一个是引号字符。 "
被替换为"
。