Share via


Élément <xsl:message>

L'élément <xsl:message> envoie un message texte au tampon des messages ou à une boîte de dialogue de message, selon l'environnement dans lequel l'élément est appelé. Il génère également un message d'erreur au niveau du système qui peut être utilisé dans les mécanismes normaux de traitement des erreurs.

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

Attributs

  • terminate
    Spécifie si la transformation doit s'achever lors de l'exécution de cette instruction. Cet attribut peut avoir l'une des deux valeurs de chaîne suivantes : « yes » ou « no ». Si l'attribut terminate est défini sur « yes », le contenu de l'élément est affiché comme partie du message d'erreur au niveau du système et la transformation s'achève. S'il est défini sur « no », la transformation se poursuit et ignore le message d'erreur. La valeur par défaut est "no".

Informations sur l'élément

Nombre d'occurrences

Illimité

Éléments parents

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, éléments de sortie

Éléments enfants

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, éléments de sortie

Notes

L'élément <xsl:message> fournit un mécanisme de débogage des feuilles de style XSLT en cours. Lorsqu'un élément <xsl:message> est rencontré, si l'indicateur terminate est défini sur "yes", le processeur XSLT se ferme et envoie un message d'erreur au niveau du système. Les expressions contenues dans l'élément <xsl:message> sont évaluées en fonction du contexte actuel, faisant de <xsl:message> un bon moyen de visualiser les éléments individuels.

Exemple

La rubrique suivante fournit un exemple d'élément <xsl:message>.