共用方式為


<xsl:include> 元素

加入另一個 XSLT 檔。

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

屬性

  • href
    必要項。 統一資源識別元 (URI) 參考,可識別要包含的 XSLT 檔。

項目資訊

發生次數

無限制

父項目

xsl:stylesheetxsl:transform

項目子系

(沒有項目子系)

備註

XSLT 檔可使用 <xsl:include> 項目來包含另一個 XSLT 檔。 href 屬性值是可識別要包含之檔案的 URI 參考。 系統會根據 <xsl:include> 項目的基底 URI,解析相對 URI。

<xsl:include> 項目只能是 <xsl:stylesheet> 項目的子系。

包含的項目是在 Microsoft® XML Core Services (MSXML) 中處理的,如同該項目在樹狀目錄層級一般。 請注意,這與 XML 樹狀目錄的文件物件模型 (DOM) 檢視不同。 會將 href 屬性值找到的資源剖析成 XML 文件,本文件的 <xsl:stylesheet> 項目子系會取代包含文件中的 <xsl:include> 項目。 與 <xsl:import> 不同,已包含範本規則與包含樣式表中的範本規則具有相同的匯入優先順序。 因此,當包含和已包含樣式表都包含某個項目的範本規則時,會根據文件順序呼叫範本。 如果包含樣式表的範本在已包含範本的後面,則會呼叫前者。 否則將呼叫後者。

當 XSLT 檔直接或間接包含它本身時,就會發生錯誤。

包含 XSLT 檔多次可能會產生錯誤,因為定義會重複。 當此類多次包含是間接包含時,會比較難察覺。 例如,A、B、C 和 D 都是 XSLT 檔案。 檔案 B、C 和 D 包含其他 XSLT 檔案,如下所示:

  • B 包含 A。

  • C 包含 A。

  • D 包含 B 和 C 二者。

接下來,XSLT 檔 D 將間接包含 XSLT 檔 A 兩次。 您可以避免這種錯誤,方法是將 B 的所有內容 (除了 A 以外) 分開成不同的 XSLT 檔 B1,再將 B 變為包含 B1 和 A。 接下來,同樣對 C 使用這個方法,最後將 D 變為包含 A、B1、C1。

範例

下列主題提供 <xsl:include> 的範例。