XslTransformation - задача

  • Статья

Преобразует входные данные XML с помощью XSLT или скомпилированного XSLT и выводит результат на устройство вывода или в выходной файл.

Параметры

В следующей таблице приводятся параметры задачи 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 могут содержать ссылки на другие файлы и внедренные блоки скриптов. Этим может воспользоваться злонамеренный пользователь: он может передать такие данные или таблицы стилей, которые при выполнении будут задействовать все доступные ресурсы компьютера. Не включите скрипт или document() функцию, UseTrustedSettings если таблица стилей не поступает из надежного источника. Если вы не можете проверить источник таблицы стилей или если таблица стилей не получена из надежного источника, используйте параметры 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;"/>

См. также