Share via

Elemento <xsl:include>

  • Artículo

Incluye otro archivo XSLT.

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

Atributos

  • href
    Necesario. Una referencia de identificador de recursos uniforme (URI) que identifica el archivo XSLT que va a incluirse.

Información del elemento

Número de apariciones

Ilimitado

Elementos primarios

xsl:stylesheet, xsl:transform

Elementos secundarios

(No hay elementos secundarios)

Comentarios

Un archivo XSLT puede importar otro archivo XSLT mediante un elemento <xsl:include>. El valor de atributo href es una referencia URI que identifica el archivo que se va a incluir. El URI relativo se resuelve en relación con el URI base del elemento <xsl:include>.

El elemento <xsl:include> sólo está permitido como secundario del elemento <xsl:stylesheet>.

La inclusiones son procesadas en Microsoft® XML Core Services (MSXML) como si tuvieran lugar al nivel del árbol. Tenga en cuenta que esto no es lo mismo que la vista de árbol XML del modelo de objetos de documento (DOM). El recurso ubicado mediante el valor de atributo href es analizado como documento XML, y los secundarios del elemento <xsl:stylesheet> en este documento sustituyen el elemento <xsl:include> en el documento. A diferencia de con <xsl:import>, las reglas de plantilla incluidas tienen la misma prioridad de importación que las de la hoja de estilos que incluye. De este modo, cuando las hojas de estilos que incluyen y las incluidas contienen una regla de plantilla para un elemento, el elemento llamado depende del orden del documento. Si la plantilla en la hoja de estilos que incluye sigue la plantilla incluida, se invoca la anterior. En caso contrario, se invoca la última.

Tendrá lugar un error si un archivo XSLT se incluye directa o indirectamente a sí mismo.

Incluir un archivo XSLT varias veces puede provocar errores debidos a definiciones duplicadas. Dichas inclusiones múltiples son menos obvias cuando son indirectas. Por ejemplo, A, B, C, y D son todos archivos XSLT. Los archivos B, C, y D incluyen otros archivos XSLT, tal como sigue:

  • B incluye A.

  • C incluye A.

  • D incluye B y C.

A continuación, el archivo XSLT, D, incluirá indirectamente el archivo XSLT, A, dos veces. Puede evitar este error separando todo en B (que no sea la inclusión de A) en un archivo XSLT, B1 separado y cambiando B para incluir B1 y A. A continuación, utilice este mismo enfoque en C y, finalmente, cambie D para incluir A, B1, C1.

Ejemplo

En los temas siguientes se muestra un ejemplo de <xsl:include>.