Condividi tramite

Elemento <xsl:message>

  • Articolo

L'elemento <xsl:message> invia un messaggio di testo al buffer dei messaggi o a una finestra di messaggio, a seconda dell'ambiente in cui è stata eseguita la chiamata dell'elemento. Inoltre, a livello di sistema genera un messaggio di errore a livello di sistema che può essere rilevato mediante i normali meccanismi di gestione degli errori.

<xsl:message
  terminate = "yes" | "no" >
</xsl:message>

Attributi

  • terminate
    Specifica se la trasformazione deve essere terminata dopo l'esecuzione di questa istruzione. L'attributo può essere impostato su uno dei due valori di stringa seguenti: "yes" o "no". Se l'attributo terminate è impostato su "yes", il contenuto dell'elemento verrà visualizzato come parte del messaggio di errore a livello di sistema e la trasformazione verrà terminata. Se invece è impostato su "no", la trasformazione continuerà ignorando il messaggio di errore. Il valore predefinito è "no".

Informazioni sull'elemento

Numero di occorrenze

Illimitato

Elementi padre

xsl:attribute, xsl:comment, xsl:copy, xsl:element, xsl:fallback, xsl:for-each, xsl:if, xsl:message, xsl:otherwise, xsl:param, xsl:processing-instruction, xsl:template, xsl:variable, xsl:when, xsl:with-param, elementi di output

Elementi figlio

xsl:apply-templates, xsl:attribute, xsl:call-template, xsl:choose, xsl:comment, xsl:copy, xsl:copy-of, xsl:element, xsl:for-each, xsl:if, xsl:processing-instruction, xsl:text, xsl:value-of, xsl:variable, elementi di output

Note

L'elemento <xsl:message> fornisce un meccanismo per eseguire il debug dei fogli di stile XSLT in corso di elaborazione. Quando viene rilevato un elemento <xsl:message>, se il flag terminate è impostato su "yes", il processore XSLT si interrompe e viene generato un messaggio di errore a livello di sistema. Le espressioni contenute nell'elemento <xsl:message> vengono valutate in base al contesto corrente. Pertanto, l'elemento <xsl:message> è un metodo valido per controllare i singoli elementi.

Esempio

Nell'argomento seguente viene fornito un esempio dell'elemento <xsl:message>.