Tugas XslTransformation
Transformasi input XML dengan menggunakan XSLT atau XSLT yang dikompilasi dan output ke perangkat output atau file.
Parameter
Tabel berikut ini menjelaskan parameter tugas XslTransformation.
| Parameter | Deskripsi |
|---|---|
OutputPaths |
Parameter ITaskItem[] wajib.Tentukan file output untuk transformasi XML. |
Parameters |
Parameter String opsional.Tentukan parameter ke dokumen Input XSLT. Berikan XML mentah yang menyimpan setiap parameter sebagai <Parameter Name="" Value="" Namespace="" />. |
UseTrustedSettings |
Parameter boolean opsional. Jika True, mengaktifkan pengaturan keamanan XSLT yang dilonggarkan yang memungkinkan penggunaan fungsi XSLT document() dan skrip yang disematkan. Lihat TrustedXslt. Untuk pertimbangan keamanan terkait, lihat Pertimbangan keamanan. |
XmlContent |
Parameter String opsional.Tentukan input XML sebagai string. |
XmlInputPaths |
Parameter ITaskItem[] opsional.Tentukan file input XML. |
XslCompiledDllPath |
Parameter ITaskItem opsional. Tentukan XSLT yang dikompilasi. |
XslContent |
Parameter String opsional.Tentukan input XML sebagai string. |
XslInputPath |
Parameter ITaskItem opsional. Tentukan file input XSLT. |
Keterangan
Penting
Lembar gaya XSLT dapat menyertakan referensi ke file lain dan blok skrip yang disematkan. Pengguna berbahaya dapat mengeksploitasi ini dengan memberi Anda lembar data atau gaya yang ketika dijalankan dapat menyebabkan sistem Anda memproses hingga komputer kehabisan sumber daya. Jangan aktifkan pembuatan skrip atau document() fungsi melalui UseTrustedSettings kecuali lembar gaya berasal dari sumber tepercaya. Jika Anda tidak dapat memverifikasi sumber lembar gaya, atau jika lembar gaya tidak berasal dari sumber tepercaya, gunakan pengaturan XSLT default.
Perhatikan juga bahwa memuat sumber daya eksternal, seperti skema, akan memungkinkan server apa pun yang menghosting skema untuk menemukan kemunculan build dan lokasi jaringannya.
Selain memiliki parameter yang tercantum dalam tabel, tugas ini mewarisi parameter dari kelas TaskExtension, yang mewarisi dari kelas Task. Untuk daftar parameter tambahan ini dan deskripsinya, lihat kelas dasar TaskExtension.
Contoh
Dalam contoh berikut, transformasi XSL file transform.xslt digunakan untuk mengubah file $(XmlInputFileName)xml. XML yang diubah ditulis ke $(IntermediateOutputPath)output.xml. Transformasi XSL mengambil $(Parameter1) sebagai parameter input.
<XslTransformation XslInputPath="transform.xslt"
XmlInputPaths="$(XmlInputFileName)"
OutputPaths="$(IntermediateOutputPath)output.xml"
Parameters="<Parameter Name='Parameter1' Value='$(Parameter1)'/>"/>