Partilhar via

Tarefa XslTransformation

  • Artigo

Transformações um XML de entrada usando um XSLT ou XSLT compilado e saídas para um arquivo ou um dispositivo de saída.

Parâmetros

A tabela a seguir descreve os parâmetros da tarefa XslTransformation.

Parâmetro Descrição
OutputPaths Parâmetro ITaskItem[] obrigatório.

Especifica os arquivos de saída para a transformação XML.
Parameters Parâmetro String opcional.

Especifica os parâmetros para o documento de entrada XSLT. Forneça o XML bruto que contém cada parâmetro como <Parameter Name="" Value="" Namespace="" />.
UseTrustedSettings Parâmetro booliano opcional.

Se True, habilita configurações de segurança XSLT relacionadas que permitem o uso da função document() do XSLT e dos scripts inseridos. Consulte TrustedXslt. Para considerações de segurança associadas, confira Considerações de segurança.
XmlContent Parâmetro String opcional.

Especifica a entrada XML como uma cadeia de caracteres.
XmlInputPaths Parâmetro opcional ITaskItem[].

Especifica os arquivos de entrada XML.
XslCompiledDllPath Parâmetro ITaskItem opcional.

Especifica o XSLT compilado.
XslContent Parâmetro String opcional.

Especifica a entrada XSLT como uma cadeia de caracteres.
XslInputPath Parâmetro ITaskItem opcional.

Especifica o arquivo de entrada XSLT.

Comentários

Importante

As folhas de estilos XSLT podem incluir referências a outros arquivos e blocos de script inseridos. Um usuário mal-intencionado pode explorar isso fornecendo a você folhas de dados ou estilos que, quando executados, possa obrigar o processamento pelo seu sistema até que o computador esteja com poucos recursos. Não habilite o script ou a função document() por meio de UseTrustedSettings, a menos que a folha de estilos seja proveniente de uma fonte confiável. Se você não puder verificar a origem da folha de estilos ou se a folha de estilos não for proveniente de uma fonte confiável, use as configurações padrão XSLT.

Observe também que carregar recursos externos, como esquemas, permitirá que qualquer servidor que hospede um esquema descubra uma ocorrência de compilação e seu local de rede.

Além de ter os parâmetros listados acima, essa tarefa herda parâmetros da classe TaskExtension, que herda da classe Task. Para obter uma lista desses parâmetros adicionais e suas descrições, confira Classe base TaskExtension.

Exemplo

No exemplo a seguir, um arquivo de transformação XSL transform.xslt é usado para modificar o arquivo $(XmlInputFileName). O XML transformado é gravado em $(IntermediateOutputPath)output.xml. A transformação XSL usa $(Parameter1) como um parâmetro de entrada.

    <XslTransformation XslInputPath="transform.xslt"
                       XmlInputPaths="$(XmlInputFileName)"
                       OutputPaths="$(IntermediateOutputPath)output.xml"
                       Parameters="&lt;Parameter Name='Parameter1' Value='$(Parameter1)'/&gt;"/>

Confira também