XSLT 編譯程式 (xsltc.exe) 會編譯 XSLT 樣式表,並生成組件。 然後,編譯的樣式表單可以直接傳遞至 XslCompiledTransform.Load(Type) 方法。 您無法使用 xsltc.exe產生已簽署的元件。
備註
只有 .NET Framework 才支援腳本區塊。 .NET Core 或 .NET 5 或更新版本 不支持 它們。
xsltc.exe 工具隨附於 Visual Studio 中。 如需詳細資訊,請參閱 Visual Studio 下載。
語法
xsltc [options] [/class:<name>] <sourceFile> [[/class:<name>] <sourceFile>...]
論點
| 論點 | 說明 |
|---|---|
sourceFile |
指定樣式表單的名稱。 樣式表單必須是本機檔案,或位於內部網路。 |
選項
| 選項 | 說明 |
|---|---|
/c[lass]:
name
|
指定下列樣式表單的類別名稱。 類名可以是完整限定名稱。 類別名稱預設為樣式表單的名稱。 例如,如果已編譯樣式表單 customers.xsl,則預設類別名稱會是 customers。 |
/debug[+|-] |
指定是否要產生偵錯資訊。 指定 + 或 /debug,會導致編譯程式產生偵錯資訊,並將其放入程序資料庫 (PDB) 檔案中。 產生的 PDB 檔名為 assemblyName.pdb。指定 -,如果您未指定 /debug,則不會建立偵錯資訊。 會產生零售組件。
注意: 在偵錯模式中編譯可能會影響 XSLT 效能。 |
/help |
顯示工具的命令語法和選項。 |
/nologo |
隱藏編譯程式著作權訊息,使其無法顯示。 |
/platform:
string
|
描述指定元件可以執行的平臺。 下列描述有效的平台值:x86 編譯您的組件,以由 32 位、x86 相容的 Common Language Runtime 執行x64 編譯您的程式集,以便在支援 AMD64 或 EM64T 指令集的電腦上由 64-bit Common Language Runtime 來執行。Itanium 會將您的組件編譯,使其可在具有 Itanium 處理器的電腦上由 64 位 Common Language Runtime 執行。 anycpu 編譯您的組件以在任何平台上執行。 這是預設值。 |
/out:
assemblyName
|
指定輸出的元件名稱。 如果有多個樣式表單,元件名稱預設為主要樣式表單的名稱,或第一個樣式表單的名稱。 如果樣式表包含腳本,這些腳本會被儲存至不同的組件。 腳本組件名稱是從主要組件名稱產生。 例如,如果您為元件名稱指定了 CustOrders.dll,則第一個腳本元件會命名為 CustOrders_Script1.dll。 |
/settings:
document+-, script+-, DTD+-,
|
指定是否要在樣式表單中允許 document() 函式、XSLT 腳本或檔案類型定義 (DTD)。默認行為會停用 DTD、函 document() 式和腳本的支援。 |
@
file
|
可讓您指定包含編譯程式選項的檔案。 |
? |
顯示工具的命令語法和選項。 |
備註
XSLT 解決方案可以包含多個樣式表單模組。 xsltc.exe 工具會從樣式表單產生元件。 然後可以將組件傳遞至 XslCompiledTransform.Load(Type) 方法。 這有助於降低某些 XSLT 部署案例的效能成本。
備註
您也必須在應用程式中包含編譯的組件作為參考。
xsltc.exe 工具不會驗證類別 (/class:name) 或元件 (/out:assemblyName) 名稱。 如果名稱無效,Common Language Runtime 就會擲回錯誤。
範例
下列命令會編譯樣式表,並建立名為 booksort.dll的元件。
xsltc booksort.xsl
下列命令會編譯樣式表單,並分別建立名為 booksort.dll 和 booksort.pdb 的元件和 PDB 檔案。
xsltc booksort.xsl /debug
下列命令會編譯一個包含 msxsl:script 元素的樣式表,並建立兩個名為 calc.dll 和 calc_Script1.dll的集合。
xsltc /settings:script+ calc.xsl
下列命令會啟用 DTD 處理和腳本支援,並建立兩個名為 myTest.dll 和 myTest_Script1.dll的元件。
xsltc /settings:DTD+,script+ /out:myTest calc.xsl
下列命令會編譯兩個樣式表單模組,並建立名為 booksort.dll的單一元件。
xsltc booksort.xsl output.xsl