Элемент <xsl:message>

  • Статья

Элемент <xsl:message> отправляет текстовое сообщение в буфер сообщений или в диалоговое окно сообщений, в зависимости от среды, в которой выполняется вызов элемента. Он также выдает сообщение об ошибке на уровне системы, которое можно перехватить с помощью обычных механизмов обработки ошибок.

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

Атрибуты

  • terminate
    Указывает, следует ли прерывать преобразование после выполнения этой инструкции. Этот атрибут может иметь одно из двух строковых значений: "yes" или "no". Если атрибут terminate имеет значение "yes", содержимое элемента отображается как часть сообщения об ошибке системного уровня, и преобразование прерывается. Если же атрибут имеет значение no, преобразование продолжается, а сообщение об ошибке не обрабатывается. По умолчанию имеет значение "no".

Сведения об элементе

Количество

Без ограничений

Родительские элементы

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, элементы вывода

Дочерние элементы

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, выходные элементы

Замечания

В элементе <xsl:message> реализован механизм отладки таблиц стилей XSLT при выполнении. При каждом появлении элемента <xsl:message>, если флаг terminate имеет значение "yes", процессор XSLT завершает работу и посылает сообщение об ошибке. Выражения, содержащиеся в элементе <xsl:message>, оцениваются в текущем контексте, поэтому элемент <xsl:message> представляет собой хороший метод для наблюдения за отдельными элементами.

Примеры

В следующем разделе приводится пример использования элемента <xsl:message>.