Partilhar via

Compilador XSLT (xsltc.exe)

  • Artigo

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

Nota

Os blocos de script são suportados apenas no .NET Framework. Eles não são suportados no .NET Core ou .NET 5 ou posterior.

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

Sintaxe

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

Argumento

Argumento Description
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 Description
/c[lass]: name Especifica o nome da classe para a seguinte folha de estilos. O nome da classe pode ser totalmente qualificado.

O nome da classe assume 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 as informações de depuração devem ser geradas.

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

Especificar -, que está em vigor se você não especificar /debug, faz com que nenhuma informação de depuração seja criada. Uma montagem de varejo é gerada. Nota: A compilação no modo de depuração pode afetar significativamente o desempenho do XSLT.
/help Exibe a sintaxe do comando e as opções da ferramenta.
/nologo Suprime a mensagem de direitos autorais do compilador da exibição.
/platform: string Especifica as plataformas nas quais o assembly pode ser executado. A seguir descrevemos os valores válidos da plataforma:

x86 compila seu assembly para ser executado pelo Common Language Runtime de 32 bits e compatível com x86

x64 compila seu assembly para ser executado pelo Common Language Runtime de 64 bits em um computador que suporta o conjunto de instruções AMD64 ou EM64T.

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

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

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

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

Observações

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

Nota

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:name) ou assembly (/out:assemblyName). Os erros são lançados pelo common language runtime se os nomes não forem vá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 scripts 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