Como faço para comentar um bloco de tags em XML?
Isto é, como posso comentar <staticText>
e tudo o que está dentro dele, no código abaixo?
<detail>
<band height="20">
<staticText>
<reportElement x="180" y="0" width="200" height="20"/>
<text><![CDATA[Hello World!]]></text>
</staticText>
</band>
</detail>
Eu poderia utilizar <!-- staticText-->
mas isso's apenas para tags simples (como o que eu sei), como //
em Java e C. Eu gostaria de algo mais como /** comentar **/
pode ser utilizado em Java e C, para que eu possa comentar blocos maiores de código XML.
Você pode usar esse estilo de comentário através de múltiplas linhas (que existe também em HTML)
<detail>
<band height="20">
<!--
Hello,
I am a multi-line XML comment
<staticText>
<reportElement x="180" y="0" width="200" height="20"/>
<text><![CDATA[Hello World!]]></text>
</staticText>
-->
</band>
</detail>
Se você perguntar, porque você tem erros com a sintaxe <!-- -->
, provavelmente é a seção CDATA (e lá a parte ]]>
), que então fica no meio do comentário. Ela não deve fazer diferença, mas o ideal e o mundo real podem estar um pouco separados, às vezes (especialmente quando se trata de processamento XML).
Tente mudar o ]]>
, também:
<!--detail>
<band height="20">
<staticText>
<reportElement x="180" y="0" width="200" height="20"/>
<text><![CDATA[Hello World!]--><!--]></text>
</staticText>
</band>
</detail-->
Outra coisa, que me vem à cabeça: Se o conteúdo do seu XML em algum lugar contém dois hífens, o comentário termina imediatamente aí:
<!-- <a> This is strange -- but true!</a> -->
--------------------------^ comment ends here
Isso é uma armadilha bastante comum. É herdado da forma como a SGML lida com os comentários. (Leia a especificação XML sobre este tópico)