Compilador XSLT (xsltc.exe)

  • Artículo

El compilador XSLT (xsltc.exe) compila hojas de estilo XSLT y genera un ensamblado. La hoja de estilos compilada se puede pasar directamente al método XslCompiledTransform.Load(Type). No se pueden generar ensamblados firmados con xsltc.exe.

Nota

Los bloques de scripts solo se admiten en .NET Framework. No se admiten en .NET Core ni .NET 5 o versiones posteriores.

La herramienta xsltc.exe está incluida en Visual Studio. Para obtener más información, consulte Descargas de Visual Studio.

Sintaxis

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

Argumento

Argumento Descripción
sourceFile Especifica el nombre de la hoja de estilos. La hoja de estilos debe ser un archivo local o bien estar ubicada en la intranet.

Opciones

Opción Descripción
/c[lass]: name Especifica el nombre de la clase para la hoja de estilos siguiente. El nombre de la clase puede ser completo.

De forma predeterminada, el nombre de la clase es igual al de la hoja de estilos. Por ejemplo, si se compila la hoja de estilos customer.xsl, el nombre predeterminado de la clase será customers.
/debug[+|-] Especifica si se debe generar o no información de depuración.

Si se especifica la opción + o /debug, el compilador generará información de depuración y la almacenará en el archivo de base de datos del programa (PDB). El nombre del archivo PDB generado será assemblyName.pdb.

Si se especifica -, que es lo que se usa si no se especifica /debug, no se crea información de depuración. Se genera un ensamblado listo para ser distribuido. Nota: Si se compila en modo de depuración, el rendimiento del XSLT puede verse considerablemente afectado.
/help Muestra las opciones y la sintaxis de los comandos para la herramienta.
/nologo Suprime el mensaje de copyright del compilador.
/platform: string Especifica las plataformas en las que se podrá ejecutar el ensamblado. A continuación se describen los valores permitidos para las plataformas:

x86 compila el ensamblado de forma que el CLR de 32 bits compatible con x86 pueda ejecutarlo.

x64 compila el ensamblado de forma que el CLR de 64 bits pueda ejecutarlo en equipos compatibles con el conjunto de instrucciones AMD64 o EM64T.

Itanium compila el ensamblado de forma que Common Language Runtime de 64 bits pueda ejecutarlo en equipos que tengan un procesador Itanium.

anycpu compila en ensamblado de forma que se pueda ejecutar en cualquier plataforma. Este es el valor predeterminado.
/out: assemblyName Especifica el nombre del ensamblado que se va a generar. De forma predeterminada, el nombre del ensamblado es el mismo que el de la hoja de estilos, o bien de la primera hoja de estilos, en caso de existir varias.

Si la hoja de estilos contiene scripts, éstos se guardarán en un ensamblado aparte. Los nombres de los ensamblados de scripts se generarán a partir del nombre del ensamblado principal. Por ejemplo, si especificó que el nombre del ensamblado sería CustOrders.dll, el nombre del primer ensamblado de script será CustOrders_Script1.dll.
/settings: document+-, script+-, DTD+-, Especifica si se permiten o no funciones document(), scripts XSLT o definiciones de tipo de documento (DTD) en la hoja de estilos.

De forma predeterminada, no habrá compatibilidad con DTD, con las funciones document() y con los scripts.
@ file Le permite especificar un archivo que contenga las opciones del compilador.
? Muestra las opciones y la sintaxis de los comandos para la herramienta.

Comentarios

Las soluciones XSLT puede estar compuestas por múltiples módulos de hojas de estilos. La herramienta xsltc.exe genera ensamblados a partir de hojas de estilos. Dichos ensamblados se pueden pasar al método XslCompiledTransform.Load(Type). Esto puede ayudar a reducir los costos de implementación en ciertos escenarios de XSLT.

Nota

Por otro lado, deberá incluir en su aplicación el ensamblado compilado como una referencia.

La herramienta xsltc.exe no valida los nombres de la clase (/class:nombre) o del ensamblado (/out:nombreDelEnsamblado). Si los nombres no son válidos, CLR genera errores.

Ejemplos

La siguiente instrucción compila la hoja de estilos y crea un ensamblado llamado booksort.dll.

xsltc booksort.xsl

La siguiente instrucción compila la hoja de estilos, para después crear un ensamblado y un archivo PDB que se llaman booksort.dll y booksort.pdb, respectivamente.

xsltc booksort.xsl /debug

El siguiente comando compila una hoja de estilos que contiene un elementomsxsl:script y crea dos ensamblados de nombre calc.dll y calc_Script1.dll.

xsltc /settings:script+ calc.xsl

La instrucción siguiente habilita el procesamiento DTD y el uso de scripts, para después crear dos ensamblados que se llamarán myTest.dll y myTest_Script1.dll.

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

La siguiente instrucción compila dos módulos de hoja de estilos y crea un único ensamblado llamado booksort.dll.

xsltc booksort.xsl output.xsl

Vea también