XslTransformation – úloha
Transformuje vstup XML pomocí XSLT nebo zkompilované XSLT a výstupy do výstupního zařízení nebo souboru.
Parametry
Následující tabulka popisuje parametry XslTransformation
úlohy.
Parametr | Popis |
---|---|
OutputPaths |
Požadovaný parametr ITaskItem[] .Určuje výstupní soubory pro transformaci XML. |
Parameters |
Volitelný String parametr.Určuje parametry vstupního dokumentu XSLT. Zadejte nezpracovaný KÓD XML, který obsahuje každý parametr jako <Parameter Name="" Value="" Namespace="" /> . |
UseTrustedSettings |
Volitelný logický parametr. Pokud True povolí uvolněná nastavení zabezpečení XSLT, která umožňují používat funkci XSLT document() a vložené skripty. Viz třída TrustedXslt. Související aspekty zabezpečení najdete v tématu Aspekty zabezpečení. |
XmlContent |
Volitelný String parametr.Určuje vstup XML jako řetězec. |
XmlInputPaths |
Volitelný ITaskItem[] parametr.Určuje vstupní soubory XML. |
XslCompiledDllPath |
Volitelný ITaskItem parametr. Určuje zkompilovaný soubor XSLT. |
XslContent |
Volitelný String parametr.Určuje vstup XSLT jako řetězec. |
XslInputPath |
Volitelný ITaskItem parametr. Určuje vstupní soubor XSLT. |
Poznámky
Důležité
Šablony stylů XSLT mohou obsahovat odkazy na jiné soubory a vložené bloky skriptů. Uživatel se zlými úmysly to může zneužít tím, že vám poskytne data nebo šablony stylů, které při spuštění můžou způsobit, že systém bude zpracovávat, dokud počítač nebude mít málo prostředků. Nepovolujte skriptování ani document()
funkci, UseTrustedSettings
pokud šablona stylů nepochází z důvěryhodného zdroje. Pokud nemůžete ověřit zdroj šablony stylů nebo pokud šablona stylů nepochází z důvěryhodného zdroje, použijte výchozí nastavení XSLT.
Všimněte si také, že načtení externích prostředků, jako jsou schémata, umožní každému serveru hostujícímu schéma zjistit výskyt sestavení a jeho síťové umístění.
Kromě parametrů, které jsou uvedeny v tabulce, tento úkol dědí parametry z TaskExtension třídy, která sama dědí z Task třídy. Seznam těchto dalších parametrů a jejich popisů naleznete v tématu TaskExtension základní třída.
Příklad
V následujícím příkladu se transformační soubor XSL transform.xslt používá k úpravě souboru $(XmlInputFileName)
XML . Transformovaný XML je zapsán do $(IntermediateOutputPath)output.xml
. Transformace XSL přebírá $(Parameter1)
jako vstupní parametr.
<XslTransformation XslInputPath="transform.xslt"
XmlInputPaths="$(XmlInputFileName)"
OutputPaths="$(IntermediateOutputPath)output.xml"
Parameters="<Parameter Name='Parameter1' Value='$(Parameter1)'/>"/>