Как избежать недопустимых символов VB и C-Sharp, таких как <>&
, в теге <code>
документации .Net Xml?
В приведенном ниже примере 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
символы разметки будут представлены в виде литрового текста в примере кода, вызывающем невязки таким образом, что ли?.
Кто-нибудь может привести пример, чтобы сделать все правильно?