XslTransformation 工作

  • 發行項

使用 XSLT 或已編譯的 XSLT 來轉換 XML 輸入，並輸出到輸出裝置或檔案。

參數

下表說明 XslTransformation 工作的參數。

參數 描述
OutputPaths 必要的 ITaskItem[] 參數。

指定 XML 轉換的輸出檔案。
Parameters 選擇性的 String 參數。

指定「XSLT 輸入」文件的參數。 提供原始 XML，其會以 <Parameter Name="" Value="" Namespace="" /> 的形式保留每個參數。
UseTrustedSettings 選用布林值參數。

如果為 True，則啟用寬鬆的 XSLT 安全性設定，以允許使用 XSLT document() 函式和內嵌指令碼。 請參閱 TrustedXslt。 如需相關聯的安全性考量，請參閱安全性考量。
XmlContent 選擇性的 String 參數。

以字串形式指定 XML 輸入。
XmlInputPaths 選擇性的 ITaskItem[] 參數。

指定 XML 輸入檔案。
XslCompiledDllPath 選擇性的 ITaskItem 參數。

指定已編譯的 XSLT。
XslContent 選擇性的 String 參數。

以字串形式指定 XSLT 輸入。
XslInputPath 選擇性的 ITaskItem 參數。

指定 XSLT 輸入檔案。

備註

重要

XSLT 樣式表可以包含其他檔案及內嵌指令碼區塊的參考。 居心不良的使用者會利用這一點，藉由提供您資料或樣式表，使您因執行他們而導致系統持續處理，直到電腦資源不足，來進行攻擊。 除非樣式表單來自受信任的來源，否則請勿透過 UseTrustedSettings 啟用指令碼或 document() 函式。 如果無法驗證樣式表的來源，或樣式表不是來自受信任來源，請使用預設 XSLT 設定。

另請注意，載入外部資源，例如架構，將允許裝載架構的任何伺服器探索組建發生次數及其網路位置。

除了具有表格中所列的參數之外，此工作也繼承 TaskExtension 類別的參數，而該類別本身又繼承 Task 類別。 如需這些其他參數的清單及其描述，請參閱 TaskExtension 基底類別。

範例

在下列範例中，會使用 XSL 轉換檔案 transform.xslt 來修改 xml 檔案 $(XmlInputFileName)。 轉換的 XML 會寫入 $(IntermediateOutputPath)output.xml。 XSL 轉換會接受 $(Parameter1) 作為輸入參數。

    <XslTransformation XslInputPath="transform.xslt"
                       XmlInputPaths="$(XmlInputFileName)"
                       OutputPaths="$(IntermediateOutputPath)output.xml"
                       Parameters="&lt;Parameter Name='Parameter1' Value='$(Parameter1)'/&gt;"/>

另請參閱