عنصر <xsl:message> XSLT

تعریف و استفاده

عنصر <xsl:message> پیامی را به خروجی می‌نویسد. این عنصر معمولاً برای گزارش خطا استفاده می‌شود.

این عنصر می‌تواند تقریباً هر عنصر دیگر XSL را شامل شود (<xsl:text>، <xsl:value-of> و غیره).

ویژگی terminate به شما اجازه می‌دهد انتخاب کنید که آیا باید تبدیل در صورت بروز خطا متوقف شود یا خیر.

قوانین گرامری

<xsl:message terminate="yes|no">
  <!-- Content:template -->

ویژگی

ویژگی مقدار توضیح
terminate
  • yes
  • no
اختیاری. "yes": پس از نوشتن پیام به خروجی، فرآیند را متوقف می‌کند. "no": پس از نوشتن پیام به خروجی، فرآیند را ادامه می‌دهد. پیش‌فرض "no" است.

مثال

مثال 1

مقابلة artist آیا خالی است. اگر بله، خروجی XSL را متوقف کرده و پیامی نشان می‌دهد:

<?xml version="1.0" encoding="ISO-8859-1"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:template match="/">
  <html>
  <body>
  <xsl:for-each select="catalog/cd">
    <p>Title: <xsl:value-of select="title"/><br />
    Artist:
    <xsl:if test="artist=''">
      <xsl:message terminate="yes">
        Error: Artist is an empty string!