<xsl:message>-Element
Das <xsl:message>-Element sendet eine Textnachricht entweder an den Nachrichtenpuffer oder an das Dialogfeld für Nachrichten. Dies hängt von der Umgebung ab, in der der Elementaufruf erfolgt. Zudem löst es eine Fehlermeldung auf Systemebene aus, die durch gewöhnliche Fehlerbehandlungsmechanismen aufgefangen werden kann.
<xsl:message
terminate = "yes" | "no" >
</xsl:message>
Attribute
- terminate
Gibt an, ob die Transformation mit der Ausführung dieser Anweisung enden soll. Dieses Attribut kann einen von zwei Zeichenfolgenwerten aufweisen: "yes" oder "no". Wenn dasterminate-Attribut auf "yes" festgelegt ist, wird der Inhalt des Elements als Teil der Fehlermeldung auf Systemebene angezeigt, und die Transformation wird beendet. Wenn es auf "no" festgelegt ist, wird die Transformation fortgesetzt und die Fehlermeldung ignoriert. Der Standardwert ist"no".
Elementinformationen
Anzahl der Vorkommen |
Unbegrenzt |
Übergeordnete Elemente |
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, Ausgabeelemente |
Untergeordnete Elemente |
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, Ausgabeelemente |
Hinweise
Das <xsl:message>-Element bietet einen Mechanismus zum Debuggen von XSLT-Stylesheets, die sich in Verarbeitung befinden. Jedesmal, wenn ein <xsl:message>-Element vorgefunden wird und das terminate-Flag auf "yes" festgelegt ist, wird der XSLT-Prozessor angehalten und eine Fehlermeldung auf Systemebene gesendet. Im <xsl:message>-Element enthaltene Ausdrücke werden relativ zum aktuellen Kontext ausgewertet. Somit stellt <xsl:message> eine gute Möglichkeit dar, einzelne Elemente zu überwachen.
Beispiel
Im folgenden Thema ist ein Beispiel für das <xsl:message>-Element enthalten.