Использование XML в .net-документации

Question

Я создаю документацию для проекта VB.Net и пытаюсь показать образец XML-конфигурации.

Лучшее, что я мог сделать до сих пор:

''' <summary> 
''' Description 
''' </summary> 
''' <remarks> 
''' <para>&lt;element&gt;</para> 
''' <para> &lt;child&gt;value&lt;/child&gt;</para> 
''' <para>&lt;/element&gt;</para> 
''' </remarks> 

Это проявляется как:

<element> 
<child>value</child> 
</element> 

Я хотел бы, чтобы показать, как отформатированный XML, но на данный момент, я бы доволен тем, что просто работает с отступом.

Answer 1

Если вы используете Sandcastle, the documentations предлагает встроить пример Xml кода в <![CDATA[]]> как это:

''' <summary> 
''' ... 
''' </summary> 
''' <example> 
''' <code language="xml" title="Xml Code sample"> 
''' <![CDATA[ 
''' <?xml version="1.0" encoding="utf-8"?> 
''' <element> 
''' <child>value</child> 
''' </element> 
''' ]]> 
''' </code> 
''' </example> 

Я не имел возможности проверить это пока.