通过

XslTransformation 任务

  • 项目

通过使用 XSLT 或编译的 XSLT 转换 XML 输入并输出到输出设备或文件。

参数

下表描述了 XslTransformation 任务的参数。

参数 说明
OutputPaths 必选 ITaskItem[] 参数。

指定 XML 转换的输出文件。
Parameters 可选 String 参数。

指定 XSLT 输入文档的参数。 提供将每个参数作为 <Parameter Name="" Value="" Namespace="" /> 的原始 XML。
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 设置。

另请注意，加载外部资源（如架构）将允许托管架构的任何服务器发现生成事件及其网络位置。

除了具有表中列出的参数外，此任务还将从本身继承自 Task 类的 TaskExtension 类继承参数。 有关这些其他参数的列表及其说明的信息，请参阅 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;"/>

另请参阅