Udostępnij za pośrednictwem

XslTransformation — zadanie

  • Artykuł

Przekształca dane wejściowe XML przy użyciu XSLT lub skompilowanego kodu XSLT i danych wyjściowych do urządzenia wyjściowego lub pliku.

Parametry

W poniższej tabeli opisano parametry XslTransformation zadania.

Parametr Opis
OutputPaths Wymagany parametr interfejsu ITaskItem[].

Określa pliki wyjściowe przekształcenia XML.
Parameters Opcjonalny String parametr.

Określa parametry dokumentu wejściowego XSLT. Podaj pierwotny kod XML, który przechowuje każdy parametr jako <Parameter Name="" Value="" Namespace="" />.
UseTrustedSettings Opcjonalny parametr logiczny.

Jeśli Trueparametr umożliwia złagodzenie ustawień zabezpieczeń XSLT, które umożliwiają korzystanie z funkcji XSLT document() i osadzonych skryptów. Zobacz: TrustedXslt. Aby zapoznać się ze skojarzonymi zagadnieniami dotyczącymi zabezpieczeń, zobacz Zagadnienia dotyczące zabezpieczeń.
XmlContent Opcjonalny String parametr.

Określa dane wejściowe XML jako ciąg.
XmlInputPaths Opcjonalny ITaskItem[] parametr.

Określa pliki wejściowe XML.
XslCompiledDllPath Opcjonalny ITaskItem parametr.

Określa skompilowany kod XSLT.
XslContent Opcjonalny String parametr.

Określa dane wejściowe XSLT jako ciąg.
XslInputPath Opcjonalny ITaskItem parametr.

Określa plik wejściowy XSLT.

Uwagi

Ważne

Arkusze stylów XSLT mogą zawierać odwołania do innych plików i bloków skryptów osadzonych. Złośliwy użytkownik może wykorzystać ten problem, dostarczając dane lub arkusze stylów, które po wykonaniu mogą spowodować przetworzenie systemu do momentu, gdy komputer nie będzie działać na niskim poziomie zasobów. Nie włączaj skryptów ani document() funkcji za pośrednictwem, UseTrustedSettings chyba że arkusz stylów pochodzi z zaufanego źródła. Jeśli nie możesz zweryfikować źródła arkusza stylów lub jeśli arkusz stylów nie pochodzi z zaufanego źródła, użyj domyślnych ustawień XSLT.

Należy również pamiętać, że ładowanie zasobów zewnętrznych, takich jak schematy, umożliwi każdemu serwerowi hostującemu schemat odnajdywanie wystąpienia kompilacji i jego lokalizacji sieciowej.

Oprócz parametrów wymienionych w tabeli to zadanie dziedziczy parametry z TaskExtension klasy, która sama dziedziczy po Task klasie. Aby uzyskać listę tych dodatkowych parametrów i ich opisy, zobacz TaskExtension, klasa bazowa.

Przykład

W poniższym przykładzie plik przekształcenia XSL transform.xslt służy do modyfikowania pliku $(XmlInputFileName)XML . Przekształcony kod XML jest zapisywany w pliku $(IntermediateOutputPath)output.xml. Przekształcenie XSL przyjmuje $(Parameter1) jako parametr wejściowy.

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

Zobacz też