XSLT Compiler (xsltc.exe)

Artikel
04/08/2023

Pengompilasi XSLT (xsltc.exe) mengompilasi lembar gaya XSLT dan menghasilkan assembly. Lembar gaya yang dikompilasi kemudian dapat diteruskan langsung ke metode XslCompiledTransform.Load(Type). Anda tidak dapat membuat rakitan yang ditandatangani dengan xsltc.exe.

Catatan

Blok skrip hanya didukung dalam .NET Framework. Blok skrip tidak didukung di .NET Core atau .NET 5 atau yang lebih baru.

Alat xsltc.exe disertakan dengan Visual Studio. Untuk informasi lebih lanjut, lihat Unduhan Visual Studio.

Sintaks

xsltc [options] [/class:<name>] <sourceFile> [[/class:<name>] <sourceFile>...]

Argumen

Argumen	Deskripsi
`sourceFile`	Menentukan nama lembar gaya. Lembar gaya harus berupa file lokal atau terletak di intranet.

Opsi

Opsi	Deskripsi
`/c[lass]:` `name`	Menentukan nama kelas untuk lembar gaya berikut. Nama kelas dapat sepenuhnya memenuhi syarat. Nama kelas default ke nama lembar gaya. Misalnya, jika lembar gaya customers.xsl dikompilasi, nama kelas default adalah pelanggan.
`/debug[`+\|-`]`	Menentukan apakah akan menghasilkan informasi penelusuran kesalahan. Menentukan `+` atau `/debug`, menyebabkan pengompilasi menghasilkan informasi debug dan memasukkannya ke dalam file database program (PDB). Nama file PDB yang dihasilkan adalah `assemblyName`.pdb. Menentukan `-`, yang berlaku jika Anda tidak menentukan `/debug`, menyebabkan tidak ada informasi debug yang dibuat. Rakitan ritel dibuat. Catatan: Mengompilasi dalam mode debug dapat memengaruhi performa XSLT secara signifikan.
`/help`	Menampilkan sintaks perintah dan opsi untuk alat ini.
`/nologo`	Menekan pesan hak cipta pengompilasi dari tampilan.
`/platform:` `string`	Menentukan platform tempat rakitan dapat dijalankan. Berikut ini menjelaskan nilai platform yang valid: `x86` mengompilasi rakitan Anda untuk dijalankan oleh runtime bahasa umum yang kompatibel dengan 32-bit x86 `x64` mengompilasi rakitan Anda untuk dijalankan oleh runtime bahasa umum 64-bit di komputer yang mendukung rangkaiant instruksi AMD64 atau EM64T. Itanium mengompilasi rakitan Anda untuk dijalankan oleh runtime bahasa umum 64-bit pada komputer yang memiliki prosesor Itanium. `anycpu` mengompilasi rakitan Anda untuk berjalan di platform apa pun. Ini adalah default.
`/out:` `assemblyName`	Menentukan nama rakitan yang merupakan output. Nama rakitan default ke nama lembar gaya utama atau lembar gaya pertama jika terdapat beberapa lembar gaya. Jika lembar gaya berisi skrip, skrip disimpan ke rakitan terpisah. Nama rakitan skrip dihasilkan dari nama rakitan utama. Misalnya, jika Anda menentukan CustOrders.dll untuk nama rakitan Anda, rakitan skrip pertama diberi nama CustOrders_Script1.dll.
`/settings:` `document+-, script+-, DTD+-,`	Menentukan apakah akan mengizinkan fungsi `document()`, skrip XSLT, atau definisi jenis dokumen (DTD) dalam lembar gaya. Perilaku default menonaktifkan dukungan untuk DTD, fungsi `document()`, dan skrip.
`@` `file`	Memungkinkan Anda menentukan file yang berisi opsi pengompilasi.
`?`	Menampilkan sintaks perintah dan opsi untuk alat ini.

Keterangan

Solusi XSLT dapat terdiri dari beberapa modul lembar gaya. Alat xsltc.exe menghasilkan rakitan dari lembar gaya. Rakitan kemudian dapat diteruskan ke metode XslCompiledTransform.Load(Type). Ini dapat membantu mengurangi biaya performa dalam beberapa skenario penyebaran XSLT.

Catatan

Anda juga harus menyertakan rakitan yang dikompilasi sebagai referensi dalam aplikasi Anda.

Alat xsltc.exe tidak memvalidasi nama kelas (/class:nama) atau rakitan (/out:assemblyName). Kesalahan ditampilkan oleh runtime bahasa umum jika nama tidak valid.

Contoh

Perintah berikut mengompilasi lembar gaya dan membuat rakitan bernama booksort.dll.

xsltc booksort.xsl

Perintah berikut mengompilasi lembar gaya dan membuat file rakitan dan PDB yang masing-masing diberi nama booksort.dll dan booksort.pdb.

xsltc booksort.xsl /debug

Perintah berikut mengompilasi lembar gaya yang berisi elemen msxsl:script dan membuat dua rakitan bernama calc.dll dan calc_Script1.dll.

xsltc /settings:script+ calc.xsl

Perintah berikut memungkinkan pemrosesan DTD dan dukungan skrip dan membuat dua rakitan bernama myTest.dll dan myTest_Script1.dll.

xsltc /settings:DTD+,script+ /out:myTest calc.xsl

Perintah berikut mengompilasi dua modul lembar gaya dan membuat satu rakitan bernama booksort.dll.

xsltc booksort.xsl output.xsl

Bagikan melalui