XSLT 編譯器 (xsltc.exe)
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>...]
引數
| Argument | 描述 |
|---|---|
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 位元 Common Language Runtime 所執行的組件。Itanium 會在搭載 Itanium 處理器的電腦上編譯要由 64 位元通用語言執行平台執行的組件。 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
