Compartilhar via

Compilador XSLT (xsltc.exe)

O compilador XSLT (xsltc.exe) compila folhas de estilo XSLT e gera um assembly. A folha de estilos compilada pode ser passada diretamente para o XslCompiledTransform.Load(Type) método. Você não pode gerar assemblies assinados com xsltc.exe.

Observação

Os blocos de script têm suporte apenas no .NET Framework. Eles não têm suporte no .NET Core ou no .NET 5 ou posterior.

A ferramenta xsltc.exe está incluída no Visual Studio. Para obter mais informações, consulte os Downloads do Visual Studio.

Sintaxe

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

Argumento

Argumento Descrição
sourceFile Especifica o nome da folha de estilos. A folha de estilos deve ser um arquivo local ou estar localizada na intranet.

Opções

Opção Descrição
/c[lass]: name Especifica o nome da classe para a folha de estilos a seguir. O nome da classe pode ser totalmente qualificado.

O nome da classe usa como padrão o nome da folha de estilos. Por exemplo, se a folha de estilos customers.xsl for compilada, o nome da classe padrão será customers.
/debug[+|-] Especifica se informações de depuração devem ser geradas.

Especificar + ou /debugfazer com que o compilador gere informações de depuração e coloque-as em um arquivo de banco de dados do programa (PDB). O nome do arquivo PDB gerado é assemblyName.pdb.

Especificar -, que é aplicado se você não especificar /debug, não cria nenhuma informação de depuração. Um assembly comercial é gerado. Nota: A compilação no modo de depuração pode afetar significativamente o desempenho de XSLT.
/help Exibe sintaxe de comando e opções para a ferramenta.
/nologo Suprime a exibição da mensagem de direitos autorais do compilador.
/platform: string Especifica as plataformas em que o assembly pode ser executado. O seguinte descreve os valores válidos da plataforma:

O x86 compila o assembly para ser executado pelo Common Language Runtime compatível com x86, de 32 bits

x64 compila o assembly para ser executado pelo ambiente de execução de linguagem comum de 64 bits em um computador que oferece suporte ao conjunto de instruções AMD64 ou EM64T.

O Itanium compila seu assembly para que ele seja executado pelo Common Language Runtime de 64 bits em um computador que tem um processador Itanium.

O anycpu compila o assembly para ser executado em qualquer plataforma. Esse é o padrão.
/out: assemblyName Especifica o nome do assembly que é a saída. O nome do assembly tem como padrão o nome da folha de estilos principal ou a primeira folha de estilos se várias folhas de estilos estiverem presentes.

Se a folha de estilos contiver scripts, os scripts serão salvos em um assembly separado. Nomes assembly de script são gerados do nome do assembly principal. Por exemplo, se você especificou CustOrders.dll para o nome do assembly, o primeiro assembly de script será chamado CustOrders_Script1.dll.
/settings: document+-, script+-, DTD+-, Especifica se as funções document(), o script XSLT ou a definição de tipo de documento (DTD) devem ser permitidos na folha de estilos.

O comportamento padrão desabilita o suporte para DTD, o document() e a função de scripts.
@ file Permite especificar um arquivo que contenha as opções do compilador.
? Exibe sintaxe de comando e opções para a ferramenta.

Observações

As soluções XSLT podem consistir em vários módulos de folha de estilos. A ferramenta xsltc.exe gera assemblies de folhas de estilo. Os assemblies podem então ser passados no método XslCompiledTransform.Load(Type). Isso pode ajudar a diminuir os custos de desempenho em alguns cenários de implantação XSLT.

Observação

Você também deve incluir o assembly compilado como uma referência em seu aplicativo.

A ferramenta xsltc.exe não valida os nomes de classe (/class:nome) ou assembly (/out:assemblyName). Erros serão lançados pelo Common Language Runtime se os nomes forem inválidos.

Exemplos

O comando a seguir compila a folha de estilos e cria um assembly chamado booksort.dll.

xsltc booksort.xsl

O comando a seguir compila a folha de estilos e cria um assembly e um arquivo PDB nomeados booksort.dll e booksort.pdb, respectivamente.

xsltc booksort.xsl /debug

O comando a seguir compila uma folha de estilos que contém um msxsl:script elemento e cria dois assemblies chamados calc.dll e calc_Script1.dll.

xsltc /settings:script+ calc.xsl

O comando a seguir habilita o processamento DTD e o suporte a script e cria dois assemblies chamados myTest.dll e myTest_Script1.dll.

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

O comando a seguir compila dois módulos de folha de estilos e cria um único assembly chamado booksort.dll.

xsltc booksort.xsl output.xsl

Consulte também

  • Last updated on