Элемент <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>.