Il titolo forse sembra un gioco di parole… In pratica, il problema è inserire una sezione di codice XML all’interno dei commenti di documentazione delle classi di .NET, che anch’essa è scritta in XML. In questo caso, il tag da utilizzare è
Tuttavia, se al suo interno si scrive direttamente il codice XML, una volta generata la documentazione, ad esempio con Sandcastle Help File Builder, il frammento di XML apparirà senza indentazione e “schiacciato” su una sola riga. Per mantenere la formattazione originale, è necessario racchiudere l’XML che si vuole mostrare in un tag di tipo <![CDATA[. Ad esempio:
<code lang="xml">
<![CDATA[
<config>
<add key="key1" value="value1" />
<add key="key2" value="value2" />
</config>
]]>
In questo modo, la documentazione prodotta con Sandcastle conterrà il codice XML con la formattazione originale.