XslTransformation (tarea)

  • Artículo

Transforma una entrada XML mediante una transformación XSL o una transformación XSL compilada y la envía a un dispositivo de salida o archivo.

Parámetros

En la siguiente tabla se describen los parámetros de la tarea XslTransformation .

Parámetro Descripción
OutputPaths Parámetro ITaskItem[] requerido.

Especifica los archivos de salida de la transformación XML.
Parameters Parámetro String opcional.

Especifica los parámetros del documento de entrada XSLT. Proporcione el XML sin formato que contiene cada parámetro como <Parameter Name="" Value="" Namespace="" />.
UseTrustedSettings Parámetro booleano opcional.

Si es True, permite la configuración de seguridad XSLT relajada que hace posible el uso de la función XSLT document() y los scripts insertados. Vea TrustedXslt. Para ver las consideraciones de seguridad asociadas, consulte Consideraciones de seguridad.
XmlContent Parámetro String opcional.

Especifica la entrada XML como una cadena.
XmlInputPaths Parámetro ITaskItem[] opcional.

Especifica los archivos de entrada XML.
XslCompiledDllPath Parámetro ITaskItem opcional.

Especifica el XSLT compilado.
XslContent Parámetro String opcional.

Especifica la entrada XSLT como una cadena.
XslInputPath Parámetro ITaskItem opcional.

Especifica el archivo de entrada XSLT.

Comentarios

Importante

Las hojas de estilos XLST pueden incluir referencias a otros archivos y bloques de scripts incrustados. Un usuario malintencionado puede aprovecharse de esta característica para proporcionarle datos u hojas de estilos que, cuando se ejecutan, pueden hacer que el sistema los procese hasta que el equipo se quede sin recursos. No habilite el scripting ni la función document() mediante UseTrustedSettings a menos que la hoja de estilos proceda de un origen de confianza. Si no puede comprobar el origen de la hoja de estilos, o si esta no proviene de un origen de confianza, use la configuración XSLT predeterminada.

Tenga en cuenta también que cargar recursos externos, como esquemas, permitirá que cualquier servidor que hospeda un esquema detecte una aparición de compilación y su ubicación de red.

Además de tener los parámetros que se enumeran en la tabla, esta tarea hereda los parámetros de la clase TaskExtension, que a su vez hereda de la clase Task. Para obtener una lista de estos parámetros adicionales y sus descripciones, consulte TaskExtension base class.

Ejemplo

En el ejemplo siguiente, se usa un archivo transform.xslt de transformación XSL para modificar el archivo XML $(XmlInputFileName). El XML transformado se escribe en $(IntermediateOutputPath)output.xml. La transformación XSL toma $(Parameter1) como un parámetro de entrada.

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

Consulte también