xsl:include Element

9/8/2008

Especifica uma folha estilo XSL Transformation (XSLT) para incluir.

Syntax

<xsl:include
  href = "URI-reference" />

Atributos

• href
  [exigido] Um URI (Uniform Resource Identifier) (URI) referência identificando folha de estilo para ser incluído.

Elemento informações

Número de ocorrências	Ilimitado
Elementos pai	xsl: stylesheet, xsl:Transform
Elementos filho	(Nenhum elementos filho)

Remarks

Um folha de estilo XSLT Pode Incluir folha de estilo XSLT outro usando o < xsl: Incluir > elemento. O href atributo valor é uma referência URI identificando folha de estilo para ser incluído. O relativo URI é resolvido with relation to o URI de base do < xsl: Incluir > elemento.

O < xsl: Incluir > elemento só é permitido como o filho do < xsl: stylesheet > elemento.

Inclusões são processadas na Microsoft® XML Parser (MSXML) como se eles ocorreu na árvore nível. Observe que isso não é o mesmo que a exibição da árvore de XML Document Object Model (DOM). O recurso localizado pela href atributo valor é analisada como um documento XML e os filhos do < xsl: stylesheet > elemento em substituir este documento o < xsl: Incluir > elemento no documento incluindo. O fato que regras modelo ou definições são incluídas não afeta a maneira como elas são processadas.

Um erro ocorre se uma folha estilo direta ou indiretamente inclui próprio.

Incluindo uma folhas de estilo horas múltiplo pode causar erros because of duplicado definições. Tal múltiplo inclusões são menos óbvio quando eles são indiretos. De exemplo, se folhas de estilo B inclui A folhas de estilo, folhas de estilo C inclui A folhas de estilo e folhas de estilo D inclui tanto folhas de estilo B e C folhas de estilo e, em seguida, A será ser incluído indiretamente por D duas vezes. Se todos os B, C e D for usado como estilo independentes planilhas, o erro pode ser evitado pelo separando tudo no B diferente a inclusão de um para um separar folhas de estilo B1 e alterando B para conter apenas inclusões de b1 e A, fazer o mesmo para C e, em seguida, alterando D para incluir uma, B1, C1.

Example

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

Não foi possível salvar o arquivo XML

<?xml version="1.0"?>
<?xml-stylesheet type="text/xsl" href="xslinclude.xsl"?>
<COLLECTION>
   <BOOK>
      <TITLE>Developing XML Solutions</TITLE>
      <AUTHOR>Jake Sturm</AUTHOR>
      <PUBLISHER>Microsoft Programming Series</PUBLISHER>
   </BOOK>
   <BOOK>
      <TITLE>HTML and XML for beginners</TITLE>
      <AUTHOR>Michael Morrison</AUTHOR>
      <PUBLISHER>Microsoft Press</PUBLISHER>
   </BOOK>
   <BOOK>
      <TITLE>XML Step by Step</TITLE>
      <AUTHOR>Michael Young</AUTHOR>
      <PUBLISHER>Microsoft Press</PUBLISHER>
   </BOOK>
</COLLECTION>

xslinclude.xsl

<?xml version="1.0"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xsl:space="preserve">
   <xsl:output method="xml" indent="yes" omit-xml-declaration="yes"/>
   <xsl:template match="/">
      <xsl:for-each select="COLLECTION/BOOK">
         <xsl:apply-templates select="TITLE"/>
         <xsl:apply-templates select="AUTHOR"/>
         <xsl:apply-templates select="PUBLISHER"/>
         <BR/>  <!-- add this -->
      </xsl:for-each>
   </xsl:template>
   <xsl:include href="xslincludefile.xsl" />
</xsl:stylesheet>

xslincludefile.xsl

<?xml version="1.0"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xsl:space="preserve">
   <xsl:template match="TITLE">
      Title - <xsl:value-of select="."/><BR/>
   </xsl:template>
   <xsl:template match="AUTHOR">
      Author - <xsl:value-of select="."/><BR/>
   </xsl:template>
   <xsl:template match="PUBLISHER">
      Publisher - <xsl:value-of select="."/><BR/><!-- removed second <BR/> -->
   </xsl:template>
</xsl:stylesheet>

Saída

Title - Developing XML Solutions
Author - Jake Sturm
Publisher - Microsoft Programming Series

Title - HTML and XML for beginners
Author - Michael Morrison
Publisher - Microsoft Press

Title - XML Step by Step
Author - Michael Young
Publisher - Microsoft Press

See Also

Reference

XSLT Elements
xsl:import Element