xsl:message Element

9/8/2008

O < xsl:Message > elemento envia um mensagem de texto para a reserva mensagem ou uma mensagem caixa de diálogo, depending on o ambiente no qual o chamar elemento é feita. Ele também gera um sistema-nível mensagem de erro que pode ser interceptada por meio de erro típico-mecanismos manipulação.

Syntax

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

Atributos

• finalizar
  O finalizar atributo indica que o documento XSLT deve parar processamento.

Elemento informações

Número de ocorrências	Ilimitado
Elementos pai	Qualquer elemento onde o de conteúdo é um modelo.
Elementos filho	Qualquer elemento que pode ocorrer em um modelo.

Remarks

O < xsl:Message > elemento fornece um mecanismo para depuração folhas estilo XSL Transformations (XSLT) em andamento. Sempre que um < xsl:Message > elemento for encontrado, se a finalizar sinalizador estiver definido como "yes" (o usar como padrão), em seguida, o processador XSLT fecha e envia um sistema-nível mensagem de erro. Expressões contidas dentro de < xsl:Message > elemento avaliar relativo para o atual contexto, tornando mensagem Uma boa maneira individual procurar elementos.

Se finalizar é definido como "não", em seguida, o Microsoft XML Parser (MSXML) 3.0 ignora o comando. Esta é uma boa maneira para manipulação de erro desativar sem removê-la totalmente da folha seu estilo Extensible Stylesheet Language (XSL), embora implementações futuras podem enviar essas mensagens saída para um arquivo log. (Isso não é atualmente com suporte.)

Example

O seguinte exemplo demonstra uso o < xsl:Message > elemento.

No seguinte arquivo, um nome não é fornecido para o elemento Nome no segundo elemento registro.

<?xml version="1.0"?>
<?xml-stylesheet href="message.xsl" type="text/xsl"?>
<records>
   <record>
      <name>Hansen Claus</name>
      <address>222 Cherry</address>
      <phone>425-555-0102</phone>
   </record>
   <record>
      <name></name>
      <address>312 Elm</address>
      <phone>425-555-0103</phone>
   </record>
</records>

Message.xsl

O seguinte estilo folha verifica que o elemento Nome em um elemento registro tenha sido preenchido. Se um campo Nome estiver vazio, uma mensagem indicando que o XML é inválido é saída.

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
  <xsl:template match="/">
     <xsl:apply-templates select="*"/>
     <xsl:copy-of select="."/>
  </xsl:template>

  <xsl:template match="*">
     <xsl:apply-templates select="//record"/>
  </xsl:template>

  <xsl:template match="record">
     <xsl:if test="name=''">
         <xsl:message terminate="yes">A name field is empty.
         </xsl:message>
     </xsl:if>
  </xsl:template>
</xsl:stylesheet>

Saída

A name field is empty.

See Also

Reference

XSLT Elements
xsl:comment Element