Freigeben über

<xsd:include>-Element

  • Artikel

Enthält eine andere XSLT-Datei.

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

Attribute

  • href
    Erforderlich. Ein URI-Verweis (Uniform Resource Identifier), der die einzuschließende XSLT-Datei identifiziert.

Elementinformationen

Anzahl der Vorkommen

Unbegrenzt

Übergeordnete Elemente

xsl:stylesheet, xsl:transform

Untergeordnete Elemente

(Keine untergeordneten Elemente)

Hinweise

Eine XSLT-Datei kann eine andere XSLT-Datei mithilfe des <xsl:include>-Elements einschließen. Der href-Attributwert stellt einen URI-Verweis dar, der die einzuschließende Datei identifiziert. Der relative URI wird relativ zum Basis-URI des <xsl:include>-Elements aufgelöst.

Das <xsl:include>-Element ist nur als untergeordnetes Element des <xsl:stylesheet>-Elements zulässig.

Einbindungen werden in Microsoft® XML Core Services (MSXML) so verarbeitet, als würden sie auf der Strukturebene auftreten. Beachten Sie, dass dies nicht der DOM-Ansicht (Document Object Model) der XML-Struktur entspricht. Die vom href-Attributwert angegebene Ressource wird als XML-Dokument analysiert. Die untergeordneten Elemente des <xsl:stylesheet>-Elements in diesem Dokument ersetzen das <xsl:include>-Element im enthaltenen Dokument. Im Gegensatz zu <xsl:import> gilt für die enthaltenen Vorlagenregeln dieselbe Importpriorität wie für die Vorlagenregeln im enthaltenen Stylesheet. Wenn das einzuschließende und enthaltene Stylesheet beide eine Vorlagenregel für ein Element enthalten, hängt es von der Dokumentreihenfolge ab, welche Vorlage aufgerufen wird. Wenn die Vorlage im enthaltenen Stylesheet der enthaltenen Vorlage folgt, wird die vorherige Vorlage aufgerufen. Andernfalls wird letztere aufgerufen.

Wenn sich eine XSLT-Datei direkt oder indirekt selbst enthält, tritt ein Fehler auf.

Das mehrfache Enthalten einer XSLT-Datei kann aufgrund doppelter Definitionen Fehler verursachen. Eine solche mehrfache Einbindung ist weniger deutlich erkennbar, wenn es sich um eine indirekte Einbindung handelt. Beispielsweise stellen A, B, C und D jeweils XSLT-Dateien dar. In den Dateien B, C und D sind andere XSLT-Dateien enthalten, z. B.:

  • B enthält A.

  • C enthält A.

  • D enthält sowohl B als auch C.

Dann enthält die XSLT-Datei D zweimal indirekt die XSLT-Datei A. Dieser Fehler kann vermieden werden, wenn alle Elemente in B (jedoch keine Einbindung von A) in eine separate XSLT-Datei, B1, übertragen und B so geändert wird, dass B1 und A darin enthalten sind. Verwenden Sie dann dieselbe Methode für C, und ändern Sie schließlich D, sodass A, B1 und C1 darin enthalten sind.

Beispiel

Im folgenden Thema wird ein Beispiel für <xsl:include> bereitgestellt.