Condividi tramite

Elemento <xsl:include>

  • Articolo

Include un altro file XSLT.

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

Attributi

  • href
    Obbligatorio. Un riferimento URI (Uniform Resource Identifier) che identifica il file XSLT da includere.

Informazioni sull'elemento

Numero di occorrenze

Illimitato

Elementi padre

xsl:stylesheet, xsl:transform

Elementi figlio

(Nessun elemento figlio)

Note

Un file XSLT è in grado di includere un altro file XSLT tramite l'elemento <xsl:include>. Il valore dell'attributo href è un riferimento URI che identifica il file da includere. L'URI relativo è risolto in relazione all'URI di base dell'elemento <xsl:include>.

L'elemento <xsl:include> è consentito solo come figlio dell'elemento <xsl:stylesheet>.

Le inclusioni vengono elaborate in Microsoft® XML Core Services (MSXML) come se si verificassero a livello di albero. Notare che non è la stessa cosa della visualizzazione DOM (Document Object Model) dell'albero XML. La risorsa individuata dal valore dell'attributo href viene analizzata come documento XML e l'elemento figlio dell'elemento <xsl:stylesheet> in questo documento sostituisce l'elemento <xsl:include> nel documento di inclusione. A differenza di <xsl:import>, le regole del modello incluse hanno la stessa priorità di importazione di quelle nel foglio di stile di inclusione. In tal modo, quando sia i fogli di stile di inclusione sia quelli inclusi contengono una regola di modello per un elemento, il modello richiamato dipende dall'ordine dei documenti. Se il modello nel foglio di stile di inclusione segue il modello incluso, viene richiamato il primo. In caso contrario, viene richiamato il secondo.

Si verificherà un errore se un file XSLT include se stesso direttamente o indirettamente.

L'inclusione più volte di un file XSLT può provocare errori a causa di definizioni duplicate. Tali inclusioni multiple sono meno ovvie quando sono indirette. Ad esempio, A, B, C e D sono tutti file XSLT. I file B, C e D includono altri file XSLT, come mostrato di seguito:

  • B include A.

  • C include A.

  • D include sia B che C.

Pertanto, il file XSLT D includerà due volte, indirettamente, il file XSLT A. È possibile evitare questo errore separando tutto ciò che è contenuto nel file B (ad eccezione dell'inclusione di A) in un diverso file XSLT, chiamato B1, e modificando B affinché includa i file B1 e A. Quindi si utilizza lo stesso metodo per il file C e, infine, si modifica il file D affinché includa i file A, B1 e C1.

Esempio

Nell'argomento seguente viene fornito un esempio di elemento <xsl:include>.