Partager via

XslTransformation (tâche)

  • Article

Transforme une entrée XML à l’aide d’une transformation XSLT ou XSLT compilée, et génère la sortie dans un fichier ou un périphérique de sortie.

Paramètres

Le tableau ci-dessous décrit les paramètres de la tâche XslTransformation .

Paramètre Description
OutputPaths Paramètre ITaskItem[] obligatoire.

Spécifie les fichiers de sortie de la transformation XML.
Parameters Paramètre String facultatif.

Spécifie les paramètres pour le document d’entrée XSLT. Fournissez le code XML brut qui contient chaque paramètre sous la forme <Parameter Name="" Value="" Namespace="" />.
UseTrustedSettings Paramètre booléen facultatif.

Si True, active les paramètres de sécurité XSLT assouplis qui permettent d’utiliser la fonction XSLT document() et des scripts incorporés. Consultez TrustedXslt. Pour connaître les considérations de sécurité associées, consultez Considérations de sécurité.
XmlContent Paramètre String facultatif.

Spécifie l’entrée XML sous forme de chaîne.
XmlInputPaths Paramètre ITaskItem[] facultatif.

Spécifie les fichiers d’entrée XML.
XslCompiledDllPath Paramètre ITaskItem facultatif.

Spécifie la transformation XSLT compilée.
XslContent Paramètre String facultatif.

Spécifie l’entrée XSLT sous forme de chaîne.
XslInputPath Paramètre ITaskItem facultatif.

Spécifie le fichier d’entrée XSLT.

Remarques

Important

Les feuilles de style XSLT peuvent inclure des références à d'autres fichiers et à des blocs de script intégrés. Un utilisateur malveillant peut exploiter cette fonction en fournissant des données ou feuilles de style qui, une fois exécutées, peuvent entraîner l'exécution du traitement jusqu'à l'épuisement des ressources de l'ordinateur. N’activez pas les scripts ou la fonction document() via UseTrustedSettings sauf si la feuille de style provient d’une source fiable. Si vous ne pouvez pas vérifier la source de la feuille de style ou si celle-ci ne provient pas d’une source fiable, utilisez les paramètres XSLT par défaut.

Notez également que le chargement de ressources externes, telles que les schémas, permet à n’importe quel serveur hébergeant un schéma de détecter une occurrence de build et son emplacement réseau.

En plus des paramètres répertoriés dans le tableau, cette tâche comprend des paramètres qu’elle hérite de la classe TaskExtension, qui elle-même hérite de la classe Task. Pour obtenir la liste de ces paramètres supplémentaires et leurs descriptions, consultez Classe de base TaskExtension.

Exemple

Dans l’exemple suivant, un fichier de transformation XSL transform.xslt est utilisé pour modifier le fichier xml $(XmlInputFileName). Le code XML transformé est écrit dans $(IntermediateOutputPath)output.xml. La transformation XSL prend $(Parameter1) comme paramètre d’entrée.

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

Voir aussi