Condividi tramite

XslTransformation (attività)

  • Articolo

Consente di trasformare un input XML tramite un XSLT o un XSLT compilato e di creare un file o dispositivo di output.

Parametri

Nella tabella che segue vengono descritti i parametri dell'attività XslTransformation.

Parametro Descrizione
OutputPaths Parametro ITaskItem[] obbligatorio.

Specifica i file di output per la trasformazione XML.
Parameters Parametro String facoltativo.

Specifica i parametri per il documento di input XSLT. Specificare il codice XML non elaborato che contiene ogni parametro come <Parameter Name="" Value="" Namespace="" />.
UseTrustedSettings Parametro booleano facoltativo.

Se True, abilita impostazioni di sicurezza XSLT rilassate che consentono l'uso della funzione XSLT document() e degli script incorporati. Vedere TrustedXslt. Per considerazioni sulla sicurezza associate, vedere Considerazioni sulla sicurezza.
XmlContent Parametro String facoltativo.

Specifica l'input XML sotto forma di stringa.
XmlInputPaths Parametro ITaskItem[] facoltativo.

Specifica i file di input XML.
XslCompiledDllPath Parametro ITaskItem facoltativo.

Specifica il file XSLT compilato.
XslContent Parametro String facoltativo.

Specifica l'input XSLT sotto forma di stringa.
XslInputPath Parametro ITaskItem facoltativo.

Specifica il file di input XSLT.

Osservazioni:

Importante

Nei fogli di stile XSLT possono essere inclusi riferimenti ad altri file e a blocchi di script incorporati. Un utente malintenzionato può sfruttare questa situazione fornendo dati o fogli di stile che, quando eseguiti, possono determinare l'elaborazione continua da parte del sistema finché le risorse del computer diventeranno insufficienti. Non abilitare lo scripting o la document() funzione tramite UseTrustedSettings , a meno che il foglio di stile non provenga da un'origine attendibile. Se non è possibile verificare l'origine del foglio di stile o se il foglio di stile non proviene da un'origine attendibile, utilizzare le impostazioni XSLT predefinite.

Si noti anche che il caricamento di risorse esterne, ad esempio gli schemi, consentirà a qualsiasi server che ospita uno schema di individuare un'occorrenza di compilazione e il relativo percorso di rete.

Oltre a usare i parametri elencati nella tabella, questa attività eredita i parametri dalla classe TaskExtension che a sua volta eredita dalla classe Task. Per un elenco di questi parametri aggiuntivi e le rispettive descrizioni, vedere TaskExtension Base Class.

Esempio

Nell'esempio seguente viene usato un file di trasformazione XSL transform.xslt per modificare il file $(XmlInputFileName)xml . Il codice XML trasformato viene scritto in $(IntermediateOutputPath)output.xml. La trasformazione XSL accetta $(Parameter1) come parametro di input.

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

Vedi anche