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="<Parameter Name='Parameter1' Value='$(Parameter1)'/>"/>