Freigeben über

XslTransformation-Aufgabe

  • Artikel

Transformiert eine XML-Eingabe mithilfe von XSLT oder kompiliertem XSLT-Code und gibt an ein Ausgabegerät oder eine Ausgabedatei aus

Parameter

In der folgenden Tabelle werden die Parameter der XslTransformation -Aufgabe beschrieben.

Parameter Beschreibung
OutputPaths Erforderlicher ITaskItem[]-Parameter.

Gibt die Ausgabedateien für die XML-Transformation an
Parameters Optionaler String-Parameter.

Gibt die Parameter für das XSLT-Eingabedokument an Stellt unformatierte XML-Daten bereit, die jeden Parameter als <Parameter Name="" Value="" Namespace="" /> enthalten.
UseTrustedSettings Optionaler boolescher Parameter.

Wenn True festgelegt ist, werden gelockerte XSLT-Sicherheitseinstellungen aktiviert, die die Verwendung der XSLT-Funktion document() und eingebetteter Skripts zulassen. Siehe TrustedXslt. Zugehörige Sicherheitsüberlegungen finden Sie unter Sicherheitsüberlegungen.
XmlContent Optionaler String-Parameter.

Gibt die XML-Eingabe als Zeichenfolge an
XmlInputPaths Optionaler ITaskItem[]-Parameter

Gibt die XML-Eingabedateien an
XslCompiledDllPath Optionaler ITaskItem-Parameter.

Gibt den kompilierten XSLT-Code an
XslContent Optionaler String-Parameter.

Gibt die XSLT-Eingabe als Zeichenfolge an
XslInputPath Optionaler ITaskItem-Parameter.

Gibt die XSLT-Eingabedatei an

Hinweise

Wichtig

XSLT-Stylesheets können Verweise auf andere Dateien und eingebettete Skriptblöcke enthalten. Ein böswilliger Benutzer kann dies ausnutzen, indem er Daten oder Stylesheets bereitstellt, deren Verarbeitung die Ressourcen des Computers erschöpft. Aktivieren Sie die Skripterstellung oder die document()-Funktion UseTrustedSettings nur dann, wenn das Stylesheet aus einer vertrauenswürdigen Quelle stammt. Wenn Sie die Quelle des Stylesheets nicht überprüfen können oder das Stylesheet nicht aus einer vertrauenswürdigen Quelle stammt, verwenden Sie die XSLT-Standardeinstellungen.

Beachten Sie außerdem, dass das Laden externer Ressourcen, z. B. Schemas, allen Servern, die ein Schema hosten, das Einbauelement und den Netzwerkspeicherort erkennt.

Zusätzlich zu den in der Tabelle aufgeführten Parametern erbt dieser Task Parameter von der TaskExtension-Klasse, die selbst von der Task-Klasse erbt. Eine Liste mit diesen zusätzlichen Parametern und ihren Beschreibungen finden Sie unter TaskExtension-Basisklasse.

Beispiel

Im folgenden Beispiel wird die XML-Datei $(XmlInputFileName) durch die XSL-Transformationsdatei transform.xslt geändert. Die transformierte XML-Datei wird in $(IntermediateOutputPath)output.xml geschrieben. Die XSL-Transformationsdatei verwendet $(Parameter1) als Eingabeparameter.

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

Weitere Informationen