Share via

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 指定样式表的名称。 样式表必须是本地文件或者位于 Intranet 上。

选项

选项 说明
/c[lass]: name 指定下面样式表的类名称。 类名称可以是完全限定的名称。

类名称默认为样式表的名称。 例如，如果编译样式表 customers.xsl，则默认类名称为 customers。
/debug[+|-] 指定是否生成调试信息。

指定 + 或 /debug 将导致编译器生成调试信息并将此信息放在程序数据库 (PDB) 文件中。 生成的 PDB 文件的名称为 assemblyName.pdb。

指定 -（在不指定 /debug 时生效）将导致不创建任何调试信息。 生成发布程序集。 注意：在调试模式下编译可能会显著影响 XSLT 性能。
/help 显示该工具的命令语法和选项。
/nologo 禁止显示编译器版权消息。
/platform: string 指定程序集可以在其上运行的平台。 下面说明有效的平台值：

x86 将程序集编译成可由 32 位、x86 兼容的公共语言运行库运行

x64 将程序集编译成可由 64 位公共语言运行库在支持 AMD64 或 EM64T 指令集的计算机上运行。

Itanium 将程序集编译成可由 64 位公共语言运行时在采用 Itanium 处理器的计算机上运行。

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: 名称）或程序集（/out:assemblyName）名称。 如果名称无效，公共语言运行时将引发错误。

示例

下面的命令编译样式表并创建一个名为 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

请参阅